Connect Mindomo to Claude, ChatGPT, Codex, Cursor, and other MCP clients. Ask in plain language, and your assistant searches, reads, creates, edits, and exports the diagrams in your Mindomo account.
GChatGPT updated 14 tasksOwners and due dates added
Your AI assistant
Turn my launch notes into a mind map. Put each channel on its own branch and add owners to the tasks.
Mindomo · build_diagram
Mindomo · edit_topics
Done. I created Q3 Product Launch with 5 channel branches and 14 tasks, each with an owner. Open in Mindomo
VCopilot exported a filelaunch-plan.pdf
How it works
Connect once, then just ask
Setup takes about a minute. After that, your assistant picks the right Mindomo tools on its own and tells you what it changed.
1Add the server
Paste the Mindomo server URL into your AI client
Every client uses the same URL. You can also hand it to your agent and ask it to connect. It handles the setup for you.
Server URLhttps://www.mindomo.com/mcpTransport: Streamable HTTP
2Sign in and approve
Approve access on the Mindomo consent screen
A browser window opens. Sign in to your Mindomo account, review the permissions the assistant requests, and allow access. Nothing to copy or paste.
Claude is connecting to MindomoRead your diagramsCreate new diagramsEdit your diagramsDenyAllow access
3Work in plain language
Ask for a map, a summary, or a change
Describe what you want. The assistant builds or updates the diagram in your account and reports back with a link.
Add a Budget branch to my launch map with three sub-topics.Added Budget with Paid media, Agency fees and Contingency.
Install and connect
Set up Mindomo in your client
Pick the tool you use. Every client connects to the same server URL and signs in through your browser.
Transport:
Streamable HTTP
Authentication:
OAuth 2.1 (browser sign-in)
Server URL:
https://www.mindomo.com/mcp
Give the server URL to any MCP-compatible agent and ask it to connect. It handles the setup and opens a browser window for you to sign in.
Server URL
https://www.mindomo.com/mcp
Or send your agent this message
Connect me to the Mindomo MCP server at https://www.mindomo.com/mcp. Transport: Streamable HTTP. Auth: OAuth 2.1, so a browser window will open for me to approve access. Once connected, list the tools you can use.
Works in Claude on the web and in the desktop app.
1Open Settings, then Connectors.
2Click Add custom connector.
3Name it Mindomo and paste the server URL.
4Click Connect, sign in to Mindomo and approve access.
Server URL
https://www.mindomo.com/mcp
Add the server from your terminal, then sign in from inside Claude Code.
1Run the command below.
2Start Claude Code and type /mcp.
3Select mindomo and finish signing in in your browser.
Terminal
claude mcp add --transport http mindomo https://www.mindomo.com/mcp
Add Mindomo as a custom connector.
1Open Settings, then Apps & Connectors.
2Under Advanced settings, turn on Developer mode.
3Click Create, name it Mindomo and paste the server URL.
4Choose OAuth, sign in to Mindomo and approve access.
Server URL
https://www.mindomo.com/mcp
Add the server with the Codex CLI. The Codex IDE extension uses the same settings.
1Add the Mindomo server.
2Sign in. A browser window opens for you to approve access.
The assistant works on the same maps you open on the web, desktop, and mobile apps. You describe what you want, and it picks the right tool. See the full tool reference
Read
List the diagrams you own, read a whole map with its relations and boundaries, or read a single branch. The assistant can read maps shared with you too, and show a map right in the chat in clients that support it.
“Summarize the Risks branch of my Q3 launch map.”
Search Premium
Find diagrams and topics by keyword, task, assignee, or date, across everything you can access.
“Which of my maps have tasks assigned to Ana this week?”
Create
Build a full diagram in one step, with nested topics, relations, boundaries, summaries, and a theme.
“Make a mind map from these meeting notes.”
Edit
Add, rename, move or delete topics, and set notes, links, and icons. Link ideas with relations, group them with boundaries and summaries, add comments, and undo any change the assistant made.
“Move Hiring under Operations and add a short note to each topic.”
Plan tasks Premium
Turn topics into real tasks with due dates, priority, progress, duration, milestones, and assignees. They appear in your task list and due-date reminders, and in the Gantt view on Professional.
“Give every task under Email an owner and a due date next week.”
Style
Switch a map's layout, apply any built-in theme, or change its background. Create your own custom themes on Premium.
“Turn this into an org chart with a calm blue theme.”
Templates Premium
Turn a map into a reusable template, with placeholder topics to fill in, guidance for each section, and branches you can add again and again.
“Make this onboarding plan a template I can reuse for every new hire.”
Export Premium
Export to plain text or the Mindomo format for free, or to PDF, PNG, SVG, Word, Markdown, OPML, and more on Premium. Excel and PowerPoint need Professional.
“Export this map as a PDF.”
Security and data access
You decide what the assistant can touch
Every connection asks for specific permissions, and you approve them on a Mindomo consent screen.
Connections use OAuth 2.1. You never share your Mindomo password with the assistant.
Disconnect an assistant any time from the MCP page in your Mindomo account. Its access is revoked immediately.
The assistant only reaches diagrams you can already open, with the rights you have on them.
Deleted diagrams stay in the recycle bin for 30 days, and the assistant can undo its own changes for 30 days. It never reverts edits made by people.
To show a map inside the chat, Mindomo may create a read-only viewer link for it, which you can revoke.
Permissions you can grant
diagrams:read
List, read, search and export diagrams
diagrams:create
Create new diagrams
diagrams:write
Edit topics, tasks, relations, boundaries, summaries, comments, templates, and style
diagrams:delete
Move a diagram to the recycle bin
themes:access
Browse, apply, and create themes
Common questions
FAQ
What is the Mindomo MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants use tools from other apps. The Mindomo MCP server gives assistants such as Claude and ChatGPT tools to search, read, create, edit, style, and export the diagrams in your Mindomo account. You describe what you want, and the assistant picks the right tool.
Which clients are supported?
Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code with GitHub Copilot, and any MCP client that supports Streamable HTTP and OAuth sign-in. They all use the same server URL: https://www.mindomo.com/mcp
Do I need an API key?
No. You sign in with OAuth: a browser window opens and you allow access on a Mindomo consent screen. The MCP server doesn’t accept personal API tokens. Those work only with the Mindomo REST API.
Is it free?
Yes. You can connect and work with your maps on the free plan, and it doesn’t use your Mindomo AI credits because the AI runs in your own assistant. Your plan applies the same way as in the Mindomo app, so features such as search, tasks, and templates require Premium, and free accounts have a lower rate limit.
What are the limits on the free plan?
Free accounts can hold 3 diagrams, so the assistant can’t create a new one until you delete one. Search, tasks, custom templates, custom themes, and exports other than plain text and the Mindomo format require Premium; Gantt view and Excel and PowerPoint exports require Professional. Free accounts can also make up to 100 tool calls an hour, 300 a day, and 3,000 a month, while paid plans get 1,000 an hour and 5,000 a day. When the assistant reaches a limit, it tells you why and gives you an upgrade link.
Which maps can the assistant access?
The maps you can open in Mindomo, with the same rights you have on them. It can read maps shared with you, but it can only edit or delete a map when you are allowed to. Listing shows the maps you own; search, on Premium, also covers maps shared with you.
Can it add real tasks and deadlines?
Yes. The assistant fills in Mindomo’s own task fields, such as due dates, priority, progress, milestones, and assignees, instead of typing dates into topic titles. The tasks then appear in your task list and due-date reminders, just like tasks you add yourself. Task management is part of Premium, and the Gantt view is part of Professional.
Can I see the map inside the chat?
Yes, in clients that can display interactive apps, such as ChatGPT, Claude, and VS Code. The assistant shows a live view of the map right in the conversation. Other clients get a link that opens the map in Mindomo. The in-chat view uses a read-only viewer link for the map, which you can revoke.
Where are the maps saved?
In your Mindomo account. They are the same maps you open, edit and share on the web, desktop, and mobile apps. If you have a map open while the assistant works on it, you see its changes as they happen, and the assistant shows up as a collaborator.
Will it change the layout or look of my existing maps?
Only when you ask. Adding, editing, or moving topics keeps the map’s layout and theme, and Mindomo places new topics automatically, just as when you add them yourself. The assistant can also change the layout if you ask, for example, switching to an org chart or rebalancing the branches. It can also restyle the map with a theme. Topics you styled yourself keep their style when you apply a theme, and you can ask the assistant to undo any of these changes.
Can I undo what the assistant did?
Yes. Ask it to undo a change and it reverts it. This works for its own edits from the last 30 days, and it never overwrites work someone added on top. Mindomo also keeps a version history of every diagram, and deleted diagrams stay in the recycle bin for 30 days.
How do I get an exported file?
Ask for the format you want and the assistant receives the file. What happens next depends on your client: some offer it as a download, and coding agents such as Claude Code and Codex can save it straight to a folder. Exports larger than 5 MB are refused, so export very large maps from the Mindomo app.
What does my AI provider see?
Whatever the assistant reads through Mindomo’s tools, for example, the topics of a map you ask it to summarize. Your AI provider processes that content under its own terms and privacy settings, so check those if your maps contain sensitive information.
How do I disconnect?
Open the MCP page in your Mindomo account and disconnect the assistant. Its access is revoked immediately. You can also remove the Mindomo connector from your AI client.
Bring Mindomo into your AI workflow
Turn AI conversations into collaborative maps
Start free. Connect in a minute, then open, share, and keep working on your maps in Mindomo from any device.