MCP Tools

Mindomo exposes an MCP (Model Context Protocol) server so AI assistants such as ChatGPT and Claude can work with your Mindomo diagrams on your behalf — searching, reading, creating, editing, theming and exporting maps through a set of well-defined tools.

Connecting

Endpoint: https://www.mindomo.com/mcp (a single MCP Streamable HTTP endpoint).
Authentication: OAuth 2.1 — you connect the app from your AI assistant and approve access on a Mindomo consent screen. There is no API key to copy/paste; the assistant handles the sign-in and token exchange.
Addressing: diagrams are referenced by their GUID; topics, relations, boundaries and summaries by a short shortId returned in read/search results.
Sessions: edit sessions are automatic — write tools open one as needed and it expires on its own. There is nothing to open or close.

Permissions (scopes)

When you connect, the app requests a set of scopes. Each tool requires one of:

Scope	Grants
`diagrams:read`	List, read, search and export diagrams
`diagrams:create`	Create new diagrams
`diagrams:write`	Edit diagram content (topics, relations, boundaries, summaries, comments, style, template)
`diagrams:delete`	Move a diagram to the recycle bin
`themes:access`	Browse, apply and author themes

Plans

The MCP tools are available on the free plan, but some capabilities follow the same plan limits as the Mindomo app. When a free (or lower-tier) account hits one of these, the tool returns a clear message with an upgrade link.

Tools

Reading diagrams

Tool	What it does	Key inputs
`list_diagrams`	List the diagrams you own	—
`get_diagram`	Get one diagram’s details (and show it inline where the host supports it)	`id`
`read_diagram`	Read a whole diagram — topics, relations, boundaries, summaries	`diagramId`
`read_branches`	Read a topic and its subtree (or all root topics)	`diagramId`, `topicId?`, `depth?`
`read_template_branches`	Read a template map’s hidden insertable prototype trees	`diagramId`, `topicId?`

Scope: diagrams:read.

Searching

Tool	What it does	Key inputs
`search_diagrams`	Keyword + filter search across all diagrams you can access	`query?`, task/assignee/date/scope filters, `limit?`
`search_topics`	The same search restricted to one diagram	`diagramId`, filters, `limit?`

Scope: diagrams:read. Premium.

Creating & managing diagrams

Tool	What it does	Key inputs
`build_diagram`	Create an entire diagram in one call — title, full nested topic tree, and optional relations/boundaries/summaries/theme/template content	`title`, `branches[]`, `relations[]?`, `boundaries[]?`, `summaries[]?`, `themeId?`
`create_diagram`	Create a new empty diagram (single root topic)	`title?`, `themeId?`
`rename_diagram`	Rename a diagram and/or set its description	`diagramId`, `name?`, `description?`
`delete_diagram`	Move a diagram to the recycle bin (recoverable)	`diagramId`

Scopes: create/build → diagrams:create; rename → diagrams:write; delete → diagrams:delete. Creating beyond the free diagram limit, or applying a custom theme in the same call, requires a paid plan.

Editing diagram content

Each editor is one tool per entity; pick the action with the op argument.

Tool	What it does	Actions (`op`)
`edit_topics`	Add, edit, move, delete or restore topics (title, notes, task data, style, icons, links, layout, template settings)	`create`, `update`, `move`, `delete`, `restore`
`edit_relations`	Concept-map links between topics	`create`, `update`, `delete`
`edit_boundaries`	Contours grouping anchored topics	`create`, `update`, `delete`
`edit_summaries`	A brace over anchored topics plus a callout topic	`create`, `update`, `delete`
`edit_comments`	Comments on a topic (author/date set by the server)	`create`, `update`, `delete`
`edit_diagram_style`	This diagram’s own background fill / multicolor / background image (no theme)	—
`edit_diagram_template`	Turn a diagram into a reusable smart template / edit its template settings	—

Scope: diagrams:write. All take diagramId.

Themes & styling

Tool	What it does	Key inputs
`list_themes`	List available themes (built-in gallery + your own)	`layout?`
`get_theme`	Get a theme’s full definition	`themeId`
`apply_theme`	Apply a theme to a diagram	`diagramId`, `themeId`
`edit_themes`	Create, update or delete a custom theme	`op` = `create` \| `update` \| `delete`

Scope: themes:access. Applying or authoring custom themes requires a paid plan; built-in themes are free.

Exporting

Tool	What it does	Key inputs
`export_diagram`	Export a diagram to a file, returned Base64-encoded (`contentBase64` + `filename` + `mimeType`)	`diagramId`, `format`

Scope: diagrams:read. Supported formats: txt, mom (free); pdf, png, svg, docx, md, opml, html, mm, mmap (Premium); xls, pptx (Professional). Very large exports are rejected — export those from the Mindomo app.

Example

A tool is called with the standard MCP tools/call request. For example, to add a topic under a diagram’s central topic:

{
  "method": "tools/call",
  "params": {
    "name": "edit_topics",
    "arguments": {
      "op": "create",
      "diagramId": "0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0",
      "branches": [{ "title": "New idea" }]
    }
  }
}