Sink GitHub

Notes that are just files.

Sink is a self-hosted, expandable notes app. Built around markdown, Sink takes the best of Obsidian and Google Keep and combines them into one place for everything you write down, on the web and on Android.

Sink in the Split layout: the notes grid with Recent, folders and pinned cards, and a launch plan open in a pane beside it
The Sink Android app: folders, Recent and pinned notes, with search and the nav pill at the bottom

Keep's speed, Obsidian's power, your server.

Jot something down in a second, write something long when you need to, and never wonder where your notes went.

A grid you can scan

Cards with colours and pins, "Take a note…", checklists. Tap one and it opens fullscreen.

An editor that stays out of the way

Live-preview markdown: headings, tasks, callouts, code, wikilinks, tags and images, with the symbols tucked away.

Plain files you own

One .md per note in a normal folder: your server, a NAS share, a Syncthing folder or an Obsidian vault.

Todos with reminders

Every - [ ] in every note, in one list, with due dates and phone notifications.

Whiteboards

Excalidraw boards for sketches and plans, saved in the same format as Obsidian's Excalidraw plugin.

Works with AI assistants

Connect Claude, ChatGPT or Poke as a custom connector to search, read and write your notes, and add todos.

An Android app that works offline

Edit on the train; it saves when you're back. Sign in with a QR code, share anything in, and on iPhone install the web app.

Email it in

Forward an email and it becomes a note, attachments and all. Send to you+todo@ and it's a todo.

Clip and import

Save any web page's article as a note. Bring everything over from Google Keep or Notion in one go.

Share and publish

Send a read-only or editable link, or put chosen notes on your own public page. Version history on every note.

Todos in your calendar

A private feed puts dated todos in Google or Apple Calendar, repeats and reminder times included.

Private, even when shared

Signed in through your own identity provider or a passkey. Invite family or friends and each gets their own private notes. No tracking, no cloud.

Four ways to lay it out.

On a big screen, pick how notes open. Your choice follows you to every browser you sign in on; phones keep their own.

Classic layout: a sidebar of folders and tags, and the notes grid on a big sheet

Write like Obsidian, from anywhere.

Point Sink at your vault and both apps edit the same files. Nothing gets converted, nothing gets locked in.

  • Properties, callouts, [[wikilinks]], ![[embeds]] and #tags
  • Tasks plugin due dates and Reminder plugin times
  • Excalidraw plugin boards open as whiteboards
  • The Sink plugin for Obsidian syncs a vault on your laptop or phone, away from home too
  • Edited in both places at once? You keep both versions, never a lost one.
The Tabs layout: four notes open as tabs, one showing a callout and tasks with due dates and priority, with its properties and outline beside it

Your notes, your assistant.

Keep only talks to Gemini. Sink speaks MCP, so Claude, ChatGPT, Poke or anything else can search, read and add to your notes. Or connect nothing. Your call.

  • Claude
  • ChatGPT
  • Poke
  • Claude Code
  • Any MCP client
  • Nothing at all

Add https://<your Sink>/mcp as a custom connector and approve it. Assistants can't delete anything for good, share, or export. How it works

Every checkbox, one list.

Todos come from the notes they live in, so the shopping list stays in the shopping note and still shows up on your phone.

  • Overdue, today, upcoming, someday
  • Tick it off on the phone and the note updates
  • Reminders arrive as notifications with a Done button
  • Priorities, repeats and quick add: "bins every tuesday"
Todos in the Android app, with due dates, priority and the note each came from
A travel note open in the Android app, with a checklist, a due date chip and a table

Running in about ten minutes.

You need Docker and an OpenID Connect sign-in provider. Pocket ID is the easiest to self-host; authentik, Authelia, Keycloak or Google work too.

1

Get the files

A compose file and an example settings file; no build needed.

2

Fill in .env

Your address, your sign-in provider, and who's allowed in.

3

Start it

Put it behind HTTPS, then install the Android app and sign in.

# Sink keeps notes in ./notes and its database in ./data
mkdir sink && cd sink
curl -O https://raw.githubusercontent.com/heycastawhat/sink/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/heycastawhat/sink/main/.env.example
# edit .env, then:
docker compose up -d

Full setup, sign-in provider examples and backup tips are in the docs.