mmm-mcp-server
This MCP server lets an AI assistant read and manage a user’s Matryoshka Mind Map content.
List accessible maps and inspect elements, hierarchy, check states, due/start dates, and document references.
Read, create, and fully update Markdown documents, including Mermaid diagrams.
Create maps and add nested structures or import Markdown into existing maps.
Edit element text, update TODO check states, set/remove dates, move elements, and delete elements with confirmation.
Sign in via browser using Google, Apple, or email, while respecting sharing permissions and read-confirmation rules.
Reads and writes Matryoshka Mind Map data stored in Firebase as the signed-in user, enabling tools to list, create, edit, delete, and move maps, nested elements, TODOs, schedules, and Markdown documents under the app's access controls.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mmm-mcp-server Matryoshkaのマップ一覧を見せて"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Matryoshka Mind Map MCP Server
English | 日本語
Work with your AI in maps, not text. Your usual AI, such as Claude, writes nested to-dos and Mermaid diagrams into Matryoshka Mind Map. You look, edit and check things off in the app, and the AI reads your changes back.

The app (free to start): Web · App Store · Google Play
How it works
sequenceDiagram
actor You
participant M as Your mmm map
participant AI as Your AI
Note over You,AI: Instead of long text back and forth, you work through the map
You-)AI: A short request: "Turn the meeting into to-dos"
AI->>M: Writes nested to-dos and diagrams
M->>You: Shows it at a glance as a diagram
You->>M: Edit and check off
M->>AI: The AI reads your edits and checks
AI->>M: Adds the next tasks and diagramsGet started → User guide
From preparing the app to connecting your AI, the recommended instructions and everyday use, in order.
Related MCP server: xmind-mcp
Privacy
It reads and writes your maps as you, only when your AI asks. The same access control as the app applies
Map contents are not stored on the server or written to logs. The server keeps only connection grants (hashed) and daily call counts (deleted after 3 days)
The days you wrote (dates and a count only) and your device's time zone are kept in a part of your account only you can read. The former is used only to count users
The first time a map's contents are read, the AI asks for your permission
You can disconnect from your AI's settings. Deleting your account removes the grants. Content passed to your AI is subject to its provider's terms
See Privacy for details.
Available Tools
14 toolsauto_structure_thoughtAInspect
会話中にClaudeが考えた階層構造を、既存のマップに追加する。深さは3階層固定ではなく任意。構造化のロジック(何をどう分解するか)はClaude側の判断で行い、このツールはFirestoreへの書き込みだけを行う。追加先(parentElementId)はlist_elementsの結果を見て判断すること。対象は既存マップのみ(新規作成が必要ならcreate_mapを先に呼ぶ)。
Inputs: mapId (required), nodes (required), parentElementId.
create_documentAInspect
マップに、Markdownの文書(MD文書)を新しく作る。指定した要素の子の末尾に、文書の要素を1つ足す(parentElementIdを省略またはnullにすると、マップの最上位の末尾)。作った文書の要素は、アプリでは書類のアイコンとタイトルで見える(タップすると整形した文書が開く。```mermaid のブロックは図になる)。中身はread_documentで読める。既存の文書の書き換えはupdate_documentを使う(これは新しく作るだけ)。contentはMarkdown(UTF-8で1000000バイトまで。超えると何も書かずにエラーを返す)。titleを省略すると、contentの最初の見出し(# の行)、無ければ最初の行がタイトルになる。追加先(parentElementId)はlist_elementsの結果を見て判断すること。
Inputs: mapId (required), content (required), title, parentElementId.
create_mapAInspect
新しいマインドマップ(マップ)を1つ作成する。list_mapsで確認して該当するマップが無いときだけ呼ぶこと。呼ぶ前に、会話でタイトル案をユーザーに提示し、明示的な確認を得ること(自動判断で勝手に作成しない)。
Inputs: title (required), isTodo (required).
delete_elementsAInspect
既存マップから要素を削除する。指定した要素とその配下(子孫)を丸ごと削除する。削除は取り返しがつかないため、まずconfirmedを省略(またはfalse)で呼び、返ってくる削除対象の一覧(パスと配下件数)をユーザーに提示して明示的な同意を得てから、confirmed: trueで呼び直すこと。
Inputs: mapId (required), elementIds (required), confirmed.
edit_elementAInspect
既存マップの要素1件の本文(detail)を書き換える。要素の追加はauto_structure_thought・import_markdown_contextを、チェック状態の変更はupdate_task_statusを使うこと。
Inputs: mapId (required), detail (required), elementId (required).
import_markdown_contextAInspect
任意の深さのMarkdown(インデントで階層を表現したリスト、見出しは#)を組み立てて、既存のマップに流し込む。見出しも1つの要素として取り込む。取り込み先がTODOマップでない場合、- [ ]/- [x]のチェックボックス記法は取り除かれチェック状態も反映されない(アプリ本体の挙動と同じ)。対象は既存マップのみ(新規作成が必要ならcreate_mapを先に呼ぶ)。
Inputs: mapId (required), markdown (required), parentElementId.
list_elementsAInspect
指定したマップ内の全要素と親子関係、チェック状態(checked)、期日(due)・着手日(start)を返す。dueとstartは付いている要素にだけあり、終日なら"YYYY-MM-DD"、時刻付きなら"YYYY-MM-DD HH:mm"(アプリで設定しているタイムゾーンの時刻)。checkedは各要素にFirestoreへ実際に保存されている生の値であり、「祖先がチェック済みなら配下も完了とみなす」という加工は行っていない。そう解釈したい場合は、返ってきたツリーを見てこちら(呼び出す側)で判断すること。呼ぶ前にユーザーへ確認しないこと。まずconfirmedを付けずに呼ぶ。アプリでAIからの読み取りを「常に許可」にしたマップは、そのまま実データを返す。それ以外のマップは、実データの代わりに確認を促すメッセージだけを返すので、そのときに限りユーザーに直接確認してからconfirmed: trueで呼び直すこと。アプリ側での直接の編集はこのツールを呼ぶまで反映されないため、ユーザーから進捗や状態を尋ねられたときは記憶に頼らず必ず呼び直すこと。MD文書の要素にはdocument(documentIdとtitle)が付く。detailは「mmmdoc://…」で始まる印とタイトルで、文書の中身はread_documentで読む。
Inputs: mapId (required), confirmed.
list_mapsAInspect
自分のMatryoshka Mind Mapの全マップ(タイトル・ID・TODOかどうか)を返す。他のツールでmapIdを指定する前に、まずこれで存在するマップとそのIDを確認する。自分が所有するマップに加え、他のユーザーから共有されて見えているマップも含む(共有マップのroleが'viewer'の場合は閲覧のみで、書き込み系ツールは使えない)。アプリ側での直接の編集(新規マップ作成等)はこのツールを呼ぶまで反映されないため、ユーザーから状態を尋ねられたときは記憶に頼らず必ず呼び直すこと。
Inputs: no named parameters.
move_elementAInspect
既存マップの要素1件(配下ごと)を、同じマップ内の別の場所へ移動する。階層をまたいだ移動(昇格・降格)も、同じ階層内の並べ替えも、これ1つで行える。
Inputs: mapId (required), elementId (required), afterElementId, newParentElementId.
read_documentAInspect
マップのMD文書の要素の中身(Markdown)を読む。読むだけで、書き込みはできない(書き換えはupdate_document)。結果のupdateTimeは、update_documentのbaseUpdateTimeにそのまま渡す。documentIdは、list_elementsが返す文書の要素のdocument.documentId。list_elementsと同じく、まずconfirmedを付けずに呼ぶ。アプリでAIからの読み取りを「常に許可」にしたマップは、そのまま実データを返す。それ以外のマップは、実データの代わりに確認を促すメッセージだけを返すので、そのときに限りユーザーに直接確認してからconfirmed: trueで呼び直すこと(同じマップでlist_elementsの確認が済んでいれば、改めて確認する必要はない)。アプリ側での直接の編集はこのツールを呼ぶまで反映されないため、記憶に頼らず必ず呼び直すこと。
Inputs: mapId (required), documentId (required), confirmed.
set_scheduleBInspect
要素の期日(due)と着手日(start)を付ける・外す。1件でも複数件でもよい。親の日付を子に引き継ぐことはしない(親と子の日付は独立している)。今の日付はlist_elementsで確認できる。
Inputs: mapId (required), updates (required).
sign_inAInspect
Matryoshka Mind Mapにサインインする。ほかのツールが「サインインしていません」と返したときに使う。ユーザーのパソコンでブラウザが開き、ユーザーがそこで承認・入力するとサインインが終わる。アプリでのサインイン方法(Google・Apple・メールアドレス+パスワード)を先にユーザーに聞いてから呼ぶこと。'email' はブラウザに入力ページを開くだけなので、メールアドレスやパスワードを会話で尋ねたり受け取ったりしてはならない。statusが'pending'なら、ブラウザでの承認・入力を済ませるようユーザーに伝え、済んだと言われたら同じmethodでもう一度呼んで結果を確かめる。
Inputs: method (required).
update_documentAInspect
マップにあるMD文書(Markdown)の中身を、新しい中身で丸ごと上書きする(一部だけの差し替えはできない。直す前にread_documentで今の中身を読み、直した全文をcontentに渡すこと)。文書の要素の位置・日付・チェックは変わらない。文書を作り直して古い方を消す必要はない。documentIdは、list_elementsが返す文書の要素のdocument.documentId。contentはUTF-8で1000000バイトまで(超えると何も書かずにエラーを返す)。titleを省略すると、新しい中身の最初の見出し(# の行)、無ければ最初の行が行のタイトルになる。baseUpdateTimeには、直前のread_documentが返したupdateTimeをそのまま渡す(必須)。read_documentで読んだあとにアプリなどで文書が変わっていた場合は、何も書かずにエラーを返す(自動ではやり直さない)ので、read_documentで読み直し、最新の中身をもとに直してやり直すこと。
Inputs: mapId (required), content (required), documentId (required), baseUpdateTime (required), +1 more.
update_task_statusAInspect
TODOマップの要素のチェック状態を書き換える。1件でも複数件でもよい。「親をチェックすると配下も完了扱いになる」というアプリ内の表示上の挙動はこのツールでは再現しない(指定した要素だけを書き換える、配下への自動連鎖はしない)。配下も揃えたい場合は、対象の要素をすべてupdatesに列挙すること。
Inputs: mapId (required), updates (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools map cleanly to a distinct resource+action: list_maps/list_elements for reads, create_map/create_document for creates, edit_element/move_element/set_schedule/update_task_status for distinct update kinds, and delete_elements/sign_in are unambiguous. The main soft spot is import_markdown_context vs auto_structure_thought, which both write hierarchical content into an existing map; the descriptions differentiate the content source, but an agent could still plausibly pick the wrong one.
Thirteen of fourteen tools follow a clear verb_noun snake_case pattern (list_elements, create_document, update_task_status, delete_elements, move_element, etc.). Only sign_in (verb+particle) and the more idiosyncratic auto_structure_thought break the pattern, which is a minor deviation rather than a different convention.
Fourteen tools sit comfortably in the well-scoped range, and each covers a real capability of the domain: map listing/creation, element CRUD-ish operations, documents, scheduling, task status, moving, and auth. Nothing looks redundant enough to be padding.
The element lifecycle is essentially covered (read via list_elements, add via auto_structure_thought/import_markdown_context, edit/move/schedule/check via the update tools, remove via delete_elements), and documents have read/create/update. Gaps remain at the container level: there is no map deletion, rename, or share management tool, and no explicit document-delete (agents must infer it via delete_elements).
Maintenance
Related MCP Connectors
Mind maps with a full document in every node. Read, search and edit your maps from AI tools.
Create, edit, and organize MindMeister mind maps from your AI assistant.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Markdown workspace for AI agents: read, write, organize, and share markdown documents.
Related MCP Servers
AlicenseBqualityDmaintenanceEnables AI assistants to interact with Maito workspaces for task management, note-taking, and planning.2113 npmAGPL 3.0- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read and write XMind mind map files, allowing generation, editing, and analysis of mind maps directly in XMind.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to build and interact with mind maps on mindmap.io. Agents can create, read, update, and delete maps and nodes, run prompts on nodes, and auto-expand topics into follow-up questions.13MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLMs to read and edit XMind mind maps, including OCR for images embedded in nodes.MIT