Schrift

Self-hosted notities, wiki en taken in Markdown. Volledig te bedienen door AI via een MCP-server, en taken synchroon met elke CalDAV-app, zoals Apple Herinneringen.

• Markdown op schijf. Elke notitie is een gewoon .md-bestand in een map. Leesbaar voor mensen, AI en andere tools.

• Taken in je tekst. Elke - [ ] in een notitie is een taak, met optioneel 📅 2026-10-20 14:00. Afvinken op je telefoon zet [x] in de notitie.

• AI-native. Een MCP-server met 27 tools geeft Claude (of een andere assistent) dezelfde mogelijkheden als jij: lezen, zoeken, schrijven, taken beheren, gespreksverslagen maken en importeren. Elke wijziging is een versie die je kunt terugdraaien.

• Rustige interface. WYSIWYG-editor, mappenboom die je zelf ordent, licht en donker thema, werkt op je telefoon als app.

Het ontwerp en de keuzes staan in docs/PLAN.md.

Functies

Related MCP server: second-brain-mcp

Zelf hosten

Schrift draait als één container met al zijn gegevens in /data. Zet hem achter een reverse proxy die HTTPS verzorgt (Caddy, Traefik, nginx…). HTTPS is verplicht, behalve op localhost.

git clone https://github.com/CasvanLeijden/Schrift.git && cd Schrift
export SCHRIFT_SECRET_KEY=$(python3 -c "import secrets; print(secrets.token_urlsafe(48))")
# Pas SCHRIFT_BASE_URL in docker-compose.yml aan naar je eigen adres.
docker compose up -d --build
docker compose exec schrift schrift user create jouwnaam --admin

Log daarna in op je adres. Bij de eerste keer stel je tweestapsverificatie in met een authenticator-app. Extra gebruikers maak je aan via Instellingen › Gebruikers.

Kant-en-klaar image en automatisch bijwerken

Elke commit op main die door de tests komt, wordt gepubliceerd als ghcr.io/casvanleijden/schrift:latest (plus een tag sha-… per commit). Wil je niet zelf bouwen, gebruik dan dat image in plaats van build: .:

services:
  schrift:
    image: ghcr.io/casvanleijden/schrift:latest

Automatisch bijwerken kan zonder dat GitHub toegang tot je server nodig heeft: laat de server periodiek het nieuwste image ophalen. docker compose up -d herstart de container alleen als het image is veranderd. Bijvoorbeeld met een systemd-timer:

# /etc/systemd/system/schrift-update.service
[Service]
Type=oneshot
WorkingDirectory=/opt/schrift
ExecStart=/usr/bin/docker compose pull -q
ExecStart=/usr/bin/docker compose up -d

# /etc/systemd/system/schrift-update.timer
[Timer]
OnBootSec=2min
OnUnitActiveSec=2min
[Install]
WantedBy=timers.target

Configuratie

Reverse proxy

Stuur alles door naar poort 8000, inclusief de paden /caldav, /.well-known/ en /mcp. Zet de headers X-Forwarded-Proto en X-Forwarded-For. Een voorbeeld voor Caddy:

schrift.example.com {
    reverse_proxy localhost:8000
}

Backup

Alles staat in /data:

• users/<id>/notes/ – de Markdown-bestanden (bron van de waarheid)

• users/<id>/attachments/ – bijlagen

• schrift.db – index, taken, versies, accounts en tokens

Maak een consistente kopie van de database voordat je /data back-upt, bijvoorbeeld:

docker compose exec schrift python -c "import sqlite3; s=sqlite3.connect('/data/schrift.db'); d=sqlite3.connect('/data/schrift.backup.db'); s.backup(d)"

Bewerk je Markdown-bestanden buiten Schrift om (bijvoorbeeld na een restore of met een ander programma)? Dan neemt schrift scan de wijzigingen op. Dat gebeurt ook automatisch bij elke start.

Taken synchroniseren (CalDAV)

1. Maak in Instellingen › CalDAV een app-wachtwoord voor je apparaat.

2. iPhone of iPad: Instellingen › Apps › Herinneringen › Herinneringen-accounts › Voeg account toe › Andere › Voeg CalDAV-account toe. Vul bij Server je domeinnaam in (schrift.example.com), plus je gebruikersnaam en het app-wachtwoord.

3. Andere apps: gebruik de server-URL https://schrift.example.com/caldav/.

Je taken verschijnen in de lijst Schrift. Taken uit een map krijgen de hoofdmap als label achter de titel, bijvoorbeeld Offerte sturen [ZOKA]. In Instellingen › CalDAV kun je mappen uitsluiten; hun taken blijven dan alleen in Schrift. Wat je in de app aanpast (afvinken, titel, datum, verwijderen), wordt teruggeschreven in de notitie. Nieuwe taken uit de app komen in je Inbox.

Claude koppelen (MCP)

claude.ai, Claude desktop en de mobiele apps: voeg een custom connector toe met de URL https://schrift.example.com/mcp. Je logt in bij Schrift en geeft toestemming.

Claude Code: maak een token in Instellingen › MCP-server en voeg de server toe:

claude mcp add --transport http schrift https://schrift.example.com/mcp \
  --header "Authorization: Bearer sk_schrift_..."

De server heeft tools voor notities (zoeken, lezen, maken, gericht bewerken, verplaatsen, verwijderen, versies), mappen, tags, taken, bijlagen, gespreksverslagen (create_meeting_report) en bulkimport (import_notes). Daarnaast zijn er twee prompts: gespreksverslag en importeren.

Ontwikkelen

Vereist: Python 3.12, uv en Node 18 of nieuwer.

cp .env.example .env
make setup      # Python- en JS-pakketten, bundels en CSS
uv run schrift user create jij --admin
make dev        # http://localhost:8000
make js-watch   # editor-bundel opnieuw bouwen bij wijzigingen
make css-watch  # Tailwind opnieuw bouwen bij wijzigingen
make test       # pytest en de editor-roundtriptests
make lint

Licentie

MIT.