MindNode MCP Server

MindNode を Claude や任意の AI エージェントに接続する — API も AppleScript もエクスポート可能なファイルも持たないマインドマップアプリのための MCP サーバー。

MindNode Next（2024 年以降の MindNode 世代）はすべてのドキュメントをプライベートな SQLite/CRDT ライブラリに移行し、自動化のための表面をゼロにしました。AppleScript 辞書も CLI もクラウド API もなく、ディスク上に .mindnode ファイルすら存在しません。このプロジェクトはストレージ形式をリバースエンジニアリングし、AI エージェントがついにマインドマップを読み書きできるようにしました：

• 読み取り — 任意のマインドマップを Markdown アウトラインとして読み取ります。MindNode のローカルライブラリから直接（SQLite → protobuf → Apple LZ4 → CRDT デコード）、読み取り専用で、アプリを起動する必要すらありません。

• 表示 — レンダリングされた正確なマップを確認できます。MindNode 自身のプレビュー JPEG で、ピクセル単位の正確さです。

• 作成 — Markdown アウトラインから新しいマインドマップを作成します（アプリ内でサイレントにインポート）。

• 開く — mindnode:// URL スキームで名前を指定して任意のマップを開きます。

Claude Code、Claude Desktop、および任意の MCP クライアントで動作します。

従来のファイルベースの MindNode をお探しですか？ 古い plist ベースのツールは .mindnode ドキュメントをカバーしています。このサーバーは MindNode Next（2024 年以降）、つまり SQLite ライブラリ世代向けであり、従来のアプローチはもはや機能しません。MindNode 2026.4.4 で検証済みです。

ツール

インストール

MindNode 2024+ と Node.js ≥ 24 を搭載した macOS が必要です。

Claude Code:

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

Claude Desktop / その他の MCP クライアント（claude_desktop_config.json）:

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

ソースから（Node ≥ 24 は TypeScript を直接実行するため、ビルド手順は不要）:

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

MCP インスペクターでデバッグ: npm run inspect。

私の使い方

私は毎日のマインドマップ（1 日 1 枚に加えて、プロジェクトごとのマップ）を作業メモとして保持しています。Raycast を設定して 1 回のキーストロークで MindNode を呼び出せるようにしているので、考えを記録するコストはゼロです。このサーバーはそのループを閉じます。1 日の終わりにエージェントがマップを読み取り、作業ログやブログの下書きに変換し、未完了のスレッドから翌日のマップをシードできます。Claude に次のようなことを依頼できます：

• 「マインドマップを一覧表示して」

• 「今日のマップを読んで、スタンドアップの更新を下書きして」

• 「このアウトラインをマインドマップに変換して: …」

仕組み

MindNode Next はすべてをサンドボックスコンテナ内の GRDB/SQLite ライブラリに保存します。各ドキュメントは protobuf の ベーススナップショット と CRDT 操作バッチ のストリームで構成され、どちらも小さなエンベロープ（フィールド 12345 = バージョン、フィールド 678910 = ペイロード — 本当にそうです）にラップされ、Apple の LZ4 フレーミング（bv41/bv4-/bv4$ ブロック）で圧縮されています。

このリポジトリには、スキーマレスな protobuf パーサー、純 TypeScript の Apple-LZ4 デコーダー、ノード作成操作とテキスト操作をリプレイするツリー再構築器が含まれています。完全なリバースエンジニアリングのメモは docs/FORMAT.md にあります。独自の MindNode ツールを構築したい場合は、そこから始めてください。tools/spelunk.py はライブラリ内の任意のブロブをさらに調査するためにプリティプリントします。

書き込みは意図的にデータベースに触れません（CloudKit と同期されているため、破損させたら取り返しがつきません）。新しいドキュメントは MindNode 自身の Markdown インポーターを open -a MindNode 経由で使用します。これはサイレントでロスレスです。

注意事項

• get_mindmap は CRDT 操作ストリームからテキストを再構築しますが、その位置エンコーディングは完全にはマッピングされていません。大幅に編集された文字列はわずかにスクランブルされて返されることがあり、削除されたノードが (untitled) として残ることがあります。正確さが重要な場合は get_mindmap_image を使用してください。create_mindmap で作成されたドキュメントはロスレスで読み戻せます。

• create_mindmap は MindNode を起動します（インポートはアプリ内でサイレントに実行されます）。

• ライブラリは常に読み取り専用で読み取られます。形式は MindNode 2026.4.4 で検証済み。将来の MindNode アップデートでフィールド番号が変わる可能性があります。アウトラインが空で返ってきた場合は、tools/spelunk.py の出力を添えて issue を報告してください。

ロードマップ

• ノードレベルの編集（単一ノードの追加/名前変更/削除）と、Shortcuts にラップされた MindNode の 20 の App Intents（CreateNode、EditNode、ExportDocument など）によるロスレスエクスポート

• 正確な読み取りのための CRDT テキスト位置エンコーディングと削除のマッピング

• フォルダタイトル、タグ/ステッカー、ノートフィールド

ライセンス

MIT