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](https://mindmapai.app) to keep editing on the full canvas. ## Quick start 1. Add `https://mindmapai.app/mcp` as a remote MCP server in your client (see [client setup](#client-setup) below). 2. Your client redirects you to MindMap AI to sign in. Create a free account if you don't have one. 3. Approve the connection. This uses OAuth 2.1. No API key is needed and your client never sees your password. 4. 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](https://claude.ai/directory/mindmap-ai). Guide: [How to use MindMap AI in Claude](https://mindmapai.app/blog/138/how-to-use-mindmap-ai-in-claude) ### ChatGPT MindMap AI is listed as a ChatGPT app. Add it from the [ChatGPT app directory](https://chatgpt.com/plugins/plugin_asdk_app_6a718a8815ec8191bdf4853e449f8853) or from your apps settings. Guide: [How to use MindMap AI in ChatGPT](https://mindmapai.app/blog/139/how-to-use-mindmap-ai-in-chatgpt) ### Claude Code ```bash 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`: ```toml [mcp_servers.mindmapai] url = "https://mindmapai.app/mcp" ``` Guide (Claude Code and Codex): [Turn a codebase into a living architecture map](https://mindmapai.app/blog/145/codebase-mind-map-claude-code-codex) ### Cursor Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global): ```json { "mcpServers": { "mindmapai": { "url": "https://mindmapai.app/mcp" } } } ``` ### VS Code (Copilot) Add to `.vscode/mcp.json`: ```json { "servers": { "mindmapai": { "type": "http", "url": "https://mindmapai.app/mcp" } } } ``` ### Windsurf Add to `~/.codeium/windsurf/mcp_config.json`: ```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](https://mindmapai.app/blog/142/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](https://mindmapai.app/blog/148/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](https://mindmapai.app/blog/149/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/`](https://github.com/MindMap-AI/mcp/blob/HEAD/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: - [Meeting notes to mind map](https://mindmapai.app/blog/144/meeting-notes-to-mind-map-chatgpt-claude) - [Codebase to living architecture map](https://mindmapai.app/blog/145/codebase-mind-map-claude-code-codex) - [Notion pages and databases to mind maps](https://mindmapai.app/blog/146/notion-to-mind-map-chatgpt-claude) ## 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](https://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](https://mindmapai.app/pricing) ## Data handling Map content is stored in your MindMap AI account under our [Privacy Policy](https://mindmapai.app/privacy). 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](https://mindmapai.app/help/mcp-connector) ## Support - Email: support@mindmapai.app - Contact form: [mindmapai.app/contact](https://mindmapai.app/contact) - Community: [Zulip chat](https://mindmapai.zulipchat.com/join/mmwtuntitk47g66joigz2hnn/) - Issues with this documentation: open a GitHub issue in this repo ## About MindMap AI is built by [3axislabs, Inc.](https://mindmapai.app/about), a Delaware corporation. Web, iOS, and Android apps at [mindmapai.app](https://mindmapai.app). The contents of this repository (documentation and configuration examples) are released under the [MIT License](https://github.com/MindMap-AI/mcp/blob/HEAD/LICENSE). The MindMap AI name, logo, and hosted service are proprietary and are not covered by that license.