MindNode MCP Server

Verbinde MindNode mit Claude und jedem KI-Agenten — ein MCP-Server für die Mind-Mapping-App, die keine API, kein AppleScript und keine exportierbaren Dateien hat.

MindNode Next (die Generation ab 2024) hat alle Dokumente in eine private SQLite/CRDT-Bibliothek verschoben und bietet keinerlei Automatisierungsschnittstelle: kein AppleScript-Wörterbuch, keine CLI, keine Cloud-API, nicht einmal .mindnode-Dateien auf der Festplatte. Dieses Projekt hat das Speicherformat rückentwickelt, damit KI-Agenten endlich Mind-Maps lesen und erstellen können:

• Lies jede Mind-Map als Markdown-Gliederung — direkt aus der lokalen MindNode-Bibliothek (SQLite → Protobuf → Apple LZ4 → CRDT-Decodierung), read-only, ohne die App überhaupt zu starten.

• Sieh die exakt gerenderte Karte — MindNode-eigene Vorschau-JPEGs, pixelgenau.

• Erstelle neue Mind-Maps aus Markdown-Gliederungen (stiller In-App-Import).

• Öffne jede Karte per Name über das mindnode://-URL-Schema.

Funktioniert mit Claude Code, Claude Desktop und jedem MCP-Client.

Auf der Suche nach dem klassischen dateibasierten MindNode? Ältere plist-basierte Tools decken .mindnode-Dokumente ab; dieser Server ist für MindNode Next (2024+), die SQLite-Bibliotheksgeneration, bei der diese Ansätze nicht mehr funktionieren. Verifiziert auf MindNode 2026.4.4.

Tools

Installation

Erfordert macOS mit MindNode 2024+ und Node.js ≥ 24.

Claude Code:

claude mcp add --scope user mindnode -- npx -y mindnode-mcp

Claude Desktop / jeder MCP-Client (claude_desktop_config.json):

{
  "mcpServers": {
    "mindnode": {
      "command": "npx",
      "args": ["-y", "mindnode-mcp"]
    }
  }
}

Aus dem Quellcode (Node ≥ 24 führt das TypeScript direkt aus, kein Build-Schritt):

git clone https://github.com/jyuwaaw/mindnode-mcp.git
cd mindnode-mcp && npm install
claude mcp add --scope user mindnode -- node /path/to/mindnode-mcp/src/index.ts

Debuggen mit dem MCP-Inspector: npm run inspect.

So nutze ich es

Ich führe eine tägliche Mind-Map (eine pro Tag, plus projektspezifische Karten) als mein Arbeitsgedächtnis — Raycast ist so eingerichtet, dass MindNode mit einem einzigen Tastendruck geöffnet wird, sodass das Festhalten eines Gedankens nichts kostet. Dieser Server schließt den Kreislauf: Am Ende des Tages liest ein Agent die Karte, verwandelt sie in ein Arbeitsprotokoll oder einen Blog-Entwurf und kann die Karte für morgen aus offenen Threads befüllen. Frag Claude zum Beispiel:

• "liste meine Mind-Maps auf"

• "lies die heutige Karte und entwirf ein Standup-Update"

• "verwandle diese Gliederung in eine Mind-Map: …"

So funktioniert es

MindNode Next speichert alles in einer GRDB/SQLite-Bibliothek in seiner Sandbox-Umgebung. Jedes Dokument ist ein protobuf Basis-Snapshot plus ein Strom von CRDT-Operations-Batches, beide in einen winzigen Umschlag verpackt (Feld 12345 = Version, Feld 678910 = Payload — ja, wirklich) und mit Apples LZ4-Framing komprimiert (bv41/bv4-/bv4$-Blöcke).

Dieses Repository enthält einen schema-losen Protobuf-Parser, einen reinen TypeScript-Apple-LZ4-Decoder und einen Baum-Rekonstruktor, der Node-Erstellungs- und Textoperationen abspielt. Die vollständigen Reverse-Engineering-Notizen findest du in docs/FORMAT.md — wenn du deine eigene MindNode-Werkzeuge bauen willst, starte dort. tools/spelunk.py gibt jede Bibliotheks-Blob hübsch formatiert aus, um weiter zu graben.

Schreibvorgänge berühren die Datenbank bewusst nicht (sie ist CloudKit-synchronisiert; sie zu beschädigen wäre unverzeihlich). Neue Dokumente laufen über MindNodes eigenen Markdown-Importer via open -a MindNode, der still und verlustfrei ist.

Einschränkungen

• get_mindmap rekonstruiert Text aus einem CRDT-Operationsstrom, dessen Positionskodierung nicht vollständig kartiert ist: stark bearbeitete Zeichenketten können leicht verfälscht zurückkommen, und gelöschte Knoten können als (untitled) übrig bleiben. Verwende get_mindmap_image, wenn es auf Exaktheit ankommt. Über create_mindmap erstellte Dokumente werden verlustfrei zurückgelesen.

• create_mindmap startet MindNode (der Import erfolgt in der App, still).

• Die Bibliothek wird immer, nur lesend geöffnet. Format verifiziert auf MindNode 2026.4.4; ein zukünftiges MindNode-Update könnte Feldnummern verschieben — melde ein Issue mit tools/spelunk.py-Ausgabe, wenn Gliederungen leer zurückkommen.

Roadmap

• Knotenebene-Bearbeitung (einzelnen Knoten hinzufügen/umbenennen/löschen) und verlustfreier Export über MindNodes 20 App Intents (CreateNode, EditNode, ExportDocument, …) verpackt in Shortcuts

• CRDT-Textpositionskodierung und Löschungen für exakte Lesevorgänge kartieren

• Ordnertitel, Tags/Sticker, Notizfelder

Lizenz

MIT