Matryoshka Mind Map MCP server

mmm-mcp-server

日本語 | English

Matryoshka Mind Map（マトリョシカ、マインドマップ／TODOアプリ）の自分のマップを、 AIエージェントとの会話から直接読み書きできるようにするツールです。MCP （Model Context Protocol）という共通規格に対応したツールなので、Claude Desktop・Claude Codeに限らず、MCPに対応したAIエージェントであれば基本的に 同じ手順で使えます（動作確認はClaude Desktop / Claude Codeで実施しています。 他のクライアントでの登録方法はそれぞれのドキュメントを参照してください）。

• 「今のマップ一覧を見せて」と話しかけるとマップ一覧を教えてくれる
• 会話の中で考えた内容を、そのままマインドマップの階層構造として追加できる
• 「〇〇のタスク終わったよ」と伝えるだけでTODOにチェックが付く
• 長いメモやMarkdownをそのままマップに流し込める

パソコンの中だけで動くツールで、常時起動しているサーバーはありません。使うときだけ 起動し、あなた自身のログイン情報であなた自身のマップにアクセスします（開発者側は あなたのデータを見ることができません）。

2026年9月30日より前に git clone で導入した方へ: アプリ側のデータ形式の

切り替えに伴い、古い版ではマップへの書き込みが失敗するようになります。下の手順5の

登録を npx -y mmm-mcp-server に置き換えてください（ログインし直す必要はありません）。

clone したまま使い続ける場合は、mmm_mcp フォルダで git pull && npm install && npm run build

を実行してからAIエージェントを再起動してください。

このページは、ある程度パソコン操作に慣れていない方でも迷わず進められるよう、

ターミナル（コマンドを打つ画面）の開き方から順に説明しています。

対応OS: macOS・Windowsの両方で動作するはずです。Node.jsだけで動く

ツールで、OS固有の機能には依存していません。ただし**実機での動作

確認はmacOSでのみ行っています。** Windowsで試して気づいた点があれば、

このリポジトリのIssueで教えてください。手順のうち、操作方法がOSで

異なる箇所（ターミナルの開き方・Node.jsのインストール）はmacOS/Windows

それぞれ記載しています。それ以外のコマンドはどちらのOSでも同じです。

1. 事前に必要なもの

Google・Apple・メールアドレスのいずれかでログインできる状態にしてください。 アプリ内の「メールアドレスを連携」機能で後から連携することもできます）

• Matryoshka Mind Mapのアカウント（匿名利用のみのアカウントは使えません。

他のMCP対応クライアントでも基本的に使えるはずです）

• MCPに対応したAIエージェント（Claude Desktop / Claude Codeで動作確認済み。

• Node.js（プログラムを動かすための土台。次の手順でインストールします）

2. ターミナルを開く

macOSの場合

1. キーボードで commandキーを押しながらスペースキーを押す（Spotlight検索が開く）
2. 「ターミナル」と入力する
3. 一覧に出てきた「ターミナル」を左クリック、またはEnterキーを押す

Windowsの場合

1. キーボードで Windowsキーを押す（スタートメニューの検索が開く）
2. 「PowerShell」と入力する
3. 一覧に出てきた「Windows PowerShell」を左クリック、またはEnterキーを押す

黒っぽい（または白い）ウィンドウが開けば準備完了です。以降の手順は、この ウィンドウに1行ずつコマンドを貼り付けてEnterキーを押していきます（コマンド 自体はmacOS・Windowsで共通です）。

3. Node.jsをインストールする

すでにインストール済みか、次のコマンドで確認できます。

node --version

v18 以上のバージョン番号（例: v20.11.0）が表示されればインストール済みです。 「command not found」のようなエラーが出た場合は、下記からインストーラーを ダウンロードしてください。

https://nodejs.org/

サイトを開くと大きなボタンが2つ出ます。「LTS」と書かれている方を左クリックして ダウンロードしてください（使っているOSに合わせて、macOSなら.pkg、Windowsなら .msiのインストーラーが自動でダウンロードされます）。ダウンロードしたファイルを ダブルクリックし、画面の指示に従って進めてください （macOSは「続ける」→「同意する」→「インストール」、Windowsは 「Next」→「I accept...」→「Install」のように、案内される通りに次へ進めば インストールできます）。

インストールが終わったら、ターミナルに戻ってもう一度確認します。

node --version

4. ログインする

Matryoshka Mind Mapアプリで普段どのログイン方法を使っているかに合わせて、 次の3つから選んでください。いずれの方法も、あなた自身が事前に何かを準備する 必要はありません。 初回はツールのダウンロードが入るので、少し時間がかかります。

Googleでログインしている場合

npx -y -p mmm-mcp-server mmm-login login --method google

ブラウザが自動で開くので、いつも使っているGoogleアカウントでログインします。

Appleでログインしている場合

npx -y -p mmm-mcp-server mmm-login login --method apple

こちらもブラウザが自動で開くので、Apple IDでログインします。

メールアドレスとパスワードでログインしている場合

npx -y -p mmm-mcp-server mmm-login login --method email

メールアドレスとパスワードを聞かれるので入力してください（パスワードは 画面に表示されません）。

「パスワードが違います」というエラーが出た場合、実際にパスワードを

間違えているとは限りません。そのアカウントがアプリ内でGoogle・Appleの

どちらかでログインしていて、そもそもメールアドレス＋パスワードでの

ログイン情報を持っていない場合も同じエラーになります。心当たりが

あれば、上の「Googleでログインしている場合」または「Appleでログイン

している場合」の手順を試してください。

ログインに成功すると、以後は毎回ログインし直す必要はありません（ログイン情報は あなたのパソコンの中だけに、あなた以外読めない形で保存されます）。

npx -y -p mmm-mcp-server mmm-login status

でログイン状態を確認できます。ログアウトしたい場合は次のコマンドです。

npx -y -p mmm-mcp-server mmm-login logout

5. AIエージェントにMatryoshkaを教える

Shortened. The full README is on GitHub.