CLI und MCP
Installiere den Befehl kajero und verbinde Claude Code oder einen anderen MCP-Client mit deinen Notizen.
Ein kajero-Befehl arbeitet auf denselben Notizen wie die App, auch bei geschlossener App. Er liest und schreibt über dieselben Dienste wie die App, sodass Zugriffsgrenzen, Validierung und Versionsverlauf für jeden Client gelten.
Den Befehl installieren
Der Befehl steckt in der App. Führe Befehlszeilenprogramm installieren … aus „Suchen und Befehle“ (⌘K) aus. Es verlinkt kajero nach /usr/local/bin; ist der Ordner nicht beschreibbar, fragt macOS nach deinem Administratorpasswort. Eine vorhandene Datei dort, die nicht von Kajero stammt, wird erst nach deiner Bestätigung ersetzt.
Das geht nur aus der gepackten App. Nach der Installation zeigt Kajero den Pfad und eine fertige MCP-Konfiguration.
Zugriff freigeben
Jeder Befehl braucht einen ausdrücklichen Bereich. Ohne einen schlägt er mit MissingScopeError fehl.
| Option | Gibt frei |
|---|---|
--workspace <slug> | Einen Workspace; wiederhole die Option für mehrere |
--inbox | Den Eingang |
--all | Jeden Workspace und den Eingang (nicht mit den beiden anderen kombinierbar) |
Ein Workspace, Ordner oder eine Notiz außerhalb der Freigabe verhält sich, als gäbe es sie nicht.
Befehle
| Befehl | Tut |
|---|---|
kajero list | Notizen auflisten (--folder, --tag) |
kajero read <note-id> | Eine Notiz als Markdown ausgeben |
kajero search <Begriffe…> | Notizen durchsuchen (--folder, --tag) |
kajero create | Notiz aus Markdown von stdin anlegen (--title, --folder, --tag) |
kajero capture | Notiz im Eingang aus Markdown von stdin anlegen (--title) |
kajero export <Verzeichnis> | Notizen als Markdown-Dateien mit Anhängen schreiben (--folder oder --note) |
kajero import <Verzeichnis> | Einen Ordner mit Markdown-Dateien in einen neuen Ordner importieren |
kajero mcp | Die Notiz-Werkzeuge über MCP auf stdio bereitstellen |
Mit --json kommt JSON statt Text (nicht bei mcp). kajero --help zeigt die ganze Hilfe.
kajero search --workspace work "quarterly plan"
echo "Call the dentist" | kajero capture --inboxClaude Code verbinden
claude mcp add kajero -- kajero mcp --workspace workErsetze work durch den Slug deines Workspace.
Anderen MCP-Client verbinden
Jeder Client, der einen stdio-MCP-Server startet, kann diese Konfiguration nutzen. Nimm den vollständigen Pfad, den der Installer zeigt (meist /usr/local/bin/kajero):
{
"mcpServers": {
"kajero": {
"command": "/usr/local/bin/kajero",
"args": ["mcp", "--workspace", "work"]
}
}
}Jede Server-Instanz sieht nur, was ihre Optionen freigeben. Um einem Agenten zwei Workspaces zu geben, wiederhole --workspace. Um Arbeit und Privates getrennt zu halten, registriere pro Kontext einen Server.
Werkzeuge
Der MCP-Server bietet: list_workspaces, list_folders, list_tags, search_notes, read_note, create_note, update_note, move_note, set_tags, archive_note, delete_note und propose_edit.
delete_note löscht weich: Die Notiz wandert in den Papierkorb. Whiteboards sind als Text lesbar, die Zeichnung selbst kann ein Agent nicht bearbeiten.
Akteur-Revisionen
Jeder Schreibzugriff eines Agenten erzeugt eine Revision mit dem Akteur agent:<client>; <client> ist der Name, den der MCP-Client beim Verbinden meldet. Ein Client ohne Namen wird abgewiesen (MissingClientNameError). Befehle, die du selbst im Terminal ausführst, werden als agent:cli festgehalten.
update_note nimmt die revision aus read_note als baseRevision. Hat sich die Notiz zwischenzeitlich geändert, schlägt der Aufruf mit StaleRevisionError fehl, und der Agent liest die Notiz neu, bevor er es erneut versucht. Ein Agent überschreibt so nie eine Änderung, die er nicht gesehen hat.
Öffne Agentenaktivität in der App (G dann A), um jede Änderung mit Diff zu sehen und per Klick zurückzunehmen.