Skip to main content
Glama

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.

Asking an AI agent to plan a trip fills a Matryoshka map, and "I booked the hotel" checks it off

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 diagrams
IMPORTANT

Get 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 tools
auto_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

    A4/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers