MindMap AI MCP Server

Create, edit, and export mind maps from Claude, ChatGPT, and any AI assistant that supports MCP.

Server URL: https://mindmapai.app/mcp

Claude Directory · ChatGPT App · Help Center · Guides

What this is

MindMap AI runs a hosted remote MCP server at https://mindmapai.app/mcp. There is nothing to install or run locally. You add the URL to your MCP client, sign in with your MindMap AI account, and start asking your assistant to build mind maps.

This repository holds the documentation, tool reference, and client configuration examples for that server. It does not contain the server source code, and the server is not self-hostable.

What it does

Once connected, you can ask your AI assistant to:

Create a new mind map from a topic, a brainstorm, notes, or documents you share in the conversation
Pull content from other connected apps (meeting notes, Notion pages, a local repo) and turn it into one map
List and search your existing mind maps
View a map's full canvas and nodes, rendered in the chat
Add, edit, move, reorder, or delete nodes
Add relationship arrows (for concept maps) and summary brackets (to group ideas)
Switch between Mind Map, Logic Chart, and Org Chart layouts
Apply themes and custom canvas styles
Export a map (formats depend on your plan)
Update an existing map in place, so you can re-run a prompt later and the same map is updated rather than recreated

Everything you create is saved to your MindMap AI account. Open any map at mindmapai.app to keep editing on the full canvas.

Quick start

Add https://mindmapai.app/mcp as a remote MCP server in your client (see client setup below).
Your client redirects you to MindMap AI to sign in. Create a free account if you don't have one.
Approve the connection. This uses OAuth 2.1. No API key is needed and your client never sees your password.
Try: "Create a mind map about the Butterfly Effect using MindMap AI."

Client setup

Claude (web, desktop, mobile)

MindMap AI is listed in the Claude connector directory. Open Settings → Connectors, find MindMap AI, and click Connect. Or go directly to claude.ai/directory/mindmap-ai.

Guide: How to use MindMap AI in Claude

ChatGPT

MindMap AI is listed as a ChatGPT app. Add it from the ChatGPT app directory or from your apps settings.

Guide: How to use MindMap AI in ChatGPT

Claude Code

claude mcp add --transport http mindmapai https://mindmapai.app/mcp

Then run /mcp inside Claude Code to complete sign-in.

OpenAI Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.mindmapai]
url = "https://mindmapai.app/mcp"

Guide (Claude Code and Codex): Turn a codebase into a living architecture map

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "mindmapai": {
      "url": "https://mindmapai.app/mcp"
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "mindmapai": {
      "type": "http",
      "url": "https://mindmapai.app/mcp"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mindmapai": {
      "serverUrl": "https://mindmapai.app/mcp"
    }
  }
}

Notion

Notion AI → connections → add a custom MCP server → paste https://mindmapai.app/mcp.

Guide: How to use MindMap AI in Notion

Gemini

Gemini → Spark → custom apps → paste https://mindmapai.app/mcp. Requires a paid Google AI plan.

Guide: How to use MindMap AI in Gemini

Perplexity

Customize → Connectors → + Custom connector → Add MCP connector → paste https://mindmapai.app/mcp. Requires a paid Perplexity plan.

Guide: How to use MindMap AI in Perplexity

Any other MCP client

If your client supports remote MCP servers with OAuth sign-in, add https://mindmapai.app/mcp and follow the sign-in prompt. The server uses dynamic client registration, so no pre-registration is needed.

Copy-paste config files for the clients above are in examples/.

Tool reference

The server exposes 20 tools. The flags below match the readOnlyHint, destructiveHint, and openWorldHint annotations the server declares, so what your client shows about each tool matches this table.

Tool	What it does	Read-only	Destructive	External fetch
`list_projects`	Lists and searches your projects	Yes	No	No
`get_canvas`	Returns the full canvas of a project	Yes	No	No
`get_schema`	Returns schema reference for tool payloads	Yes	No	No
`export_project`	Returns a project as an inline export	Yes	No	No
`create_project`	Creates a new project, optionally seeded from an outline	No	No	Yes
`add_nodes`	Adds nodes to an existing project	No	No	Yes
`update_nodes`	Edits node topics and attributes	No	Yes	Yes
`move_nodes`	Reparents or reorders nodes (subtrees stay intact)	No	No	No
`delete_nodes`	Deletes selected nodes and their subtrees	No	Yes	No
`add_arrows`	Adds relationship arrows between nodes	No	No	No
`update_arrows`	Edits arrow endpoints, labels, or styling	No	Yes	No
`delete_arrows`	Deletes selected arrows	No	Yes	No
`add_summaries`	Adds summary brackets over sibling nodes	No	No	No
`update_summaries`	Edits summary text, range, or styling	No	Yes	No
`delete_summaries`	Deletes selected summaries	No	Yes	No
`set_title`	Renames a project and updates its categories	No	Yes	No
`set_theme`	Changes the project theme	No	Yes	No
`set_chart_type`	Switches between Mind Map, Logic Chart, and Org Chart	No	Yes	No
`update_canvas`	Applies ordered raw canvas operations	No	Yes	Yes
`delete_project`	Permanently deletes a project from your workspace	No	Yes	No

External fetch means the tool can download a user-supplied public image URL and store a copy in your project (for node images). This is the only case where the server contacts an address outside MindMap AI.

Example prompts

"Create a mind map about the Butterfly Effect with MindMap AI."
"Turn these meeting notes into a mind map, grouped by decision, action item, and open question."
"Pull my last three Notion meeting pages and combine them into one mind map."
"Show me the map you just made, then add a branch for risks."
"Switch this map to an org chart and apply a dark theme."
"Export this map as Markdown."

Use-case guides:

Authentication and security

Auth: OAuth 2.1 authorization code flow with PKCE and dynamic client registration. Per-user consent. No API keys or shared secrets.
Scope: The server only accesses mind map projects in the MindMap AI account you authorize. It cannot read billing details, your password, or anything outside your maps and their metadata.
When it acts: Only when you ask your assistant to do something. It does not run in the background.
Outbound requests: None, except fetching a public image URL you supply for a node.
Revoke: Remove the connector in your client's settings, or revoke it from your MindMap AI account settings. Either one invalidates access.
Destructive tools: delete_project and delete_nodes are permanent, the same as deleting in the web app. Ask your assistant to confirm first.

Full details for IT administrators: mindmapai.app/help/mcp-connector

Credits and pricing

Connecting is free and adds a one-time credit bonus to your account.
Creating and editing maps uses AI credits from your MindMap AI account, the same balance used in the web and mobile apps. Larger changes use more credits.
Viewing, searching, and exporting never use credits (rate-limited per account).
Works on every plan, including Free. Free accounts get monthly credits that renew automatically.
Nothing is sold inside Claude, ChatGPT, or any other client. Plans: mindmapai.app/pricing

Data handling

Map content is stored in your MindMap AI account under our Privacy Policy. We do not use your map content to train AI models. Your conversations with the host assistant (Claude, ChatGPT, and others) are governed by that provider's own terms.

Troubleshooting

Problem	Fix
Assistant says it can't reach MindMap AI	Check the connector is still connected in your client. Reconnect if expired.
An edit didn't apply	Ask the assistant to show the current map, then repeat the instruction with the exact node name.
Out of credits	Creation and edits pause at zero. Viewing and exporting still work. Credits renew monthly, or upgrade.
Connected the wrong account	Disconnect in your client, then reconnect with the right account.

More: Help Center

Support

Email: [email protected]
Contact form: mindmapai.app/contact
Community: Zulip chat
Issues with this documentation: open a GitHub issue in this repo

About

MindMap AI is built by 3axislabs, Inc., a Delaware corporation. Web, iOS, and Android apps at mindmapai.app.

The contents of this repository (documentation and configuration examples) are released under the MIT License. The MindMap AI name, logo, and hosted service are proprietary and are not covered by that license.

MindMap AI MCP Server