Repolode
bretzel-app

bretzel-app/crumbs

A self-hosted, privacy-first note-taking app built with SvelteKit, offered as an alternative to Google Keep.

Open-source alternative to:Google Keep

Stars
129
Forks
9
Open issues
6
Last commit
15 days ago

What is it?

Crumbs is a self-hostable note-taking app for capturing thoughts, ideas and quick notes. It runs as a SvelteKit web app backed by SQLite, and you can deploy it with Docker or Node.js 22 on your own server.

Notes support Markdown, checklists, image attachments and 12 color themes. You can organize them with #tags, pinning, archive and trash, search across titles, content and tags, and browse or restore earlier versions of a note. Notes can be shared with other users on the same instance.

The app is a PWA that works offline by storing data in IndexedDB and syncing with LWW CRDTs. Multi-user login uses Argon2 passwords, with optional Google, GitHub or OIDC single sign-on. It also includes an MCP server so AI assistants such as Claude Code can manage your notes.

Key features

  • 01Markdown notes with checklists, image attachments and color themes
  • 02Tags, pinning, archive and trash for organizing notes
  • 03Full-text search across titles, content and tags
  • 04Version history with the ability to restore earlier note versions
  • 05Offline-capable PWA with sync via LWW CRDTs
  • 06Optional Google, GitHub and OIDC single sign-on

Use cases

  • Running a private Google Keep replacement on your own server
  • Keeping personal notes and ideas without sending them to a third-party cloud
  • Sharing notes with teammates or family on a single self-hosted instance
  • Letting AI assistants read and manage notes through the MCP server

Quick start

  1. 1

    Create a folder and move into it

    mkdir crumbs && cd crumbs
  2. 2

    Download the docker-compose.yml file

    curl -fsSLO https://raw.githubusercontent.com/bretzel-app/crumbs/main/docker-compose.yml
  3. 3

    Start Crumbs with Docker Compose

    docker compose up -d
  4. 4

    Open http://localhost:3000 in your browser and create the admin account

Things to know

  • Using it from other devices requires HTTPS and a matching ORIGIN setting; plain HTTP over a server IP will not keep you signed in.
  • The first visitor becomes admin, so you must create the account before exposing the port.

In collections

Topics

FAQ

What is crumbs?
A self-hosted, privacy-first note-taking app built with SvelteKit, offered as an alternative to Google Keep. Crumbs is a self-hostable note-taking app for capturing thoughts, ideas and quick notes. It runs as a SvelteKit web app backed by SQLite, and you can deploy it with Docker or Node.js 22 on your own server.
Is crumbs free to use? What license does it have?
crumbs is open source under the MIT license. Check the license terms before using it in commercial products.
Is crumbs still maintained?
Actively maintained. The last commit to crumbs was on Oct 22, 2026.
What can I use crumbs for?
Running a private Google Keep replacement on your own server Keeping personal notes and ideas without sending them to a third-party cloud Sharing notes with teammates or family on a single self-hosted instance Letting AI assistants read and manage notes through the MCP server
How do I install crumbs?
Create a folder and move into it: mkdir crumbs && cd crumbs Download the docker-compose.yml file: curl -fsSLO https://raw.githubusercontent.com/bretzel-app/crumbs/main/docker-compose.yml Start Crumbs with Docker Compose: docker compose up -d Open http://localhost:3000 in your browser and create the admin account
Where can I get crumbs?
The source code and installation instructions are on GitHub: https://github.com/bretzel-app/crumbs

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects