Claude Code MCP server: plan your work as a mindmap

Add the mindmap.io MCP server with one command, and Claude Code can build maps in your account and read them back.

After this guide, Claude Code can build maps in your mindmap.io account and read them back while you work in the terminal. Ask it to lay out a codebase or the options for a design decision, and the map appears in your account with a root idea, questions under it, and an answer under each question. You can open it in the browser, keep growing branches, and send a teammate the link.

mindmap.io runs a remote MCP server at https://mindmap.io/mcp. Claude Code connects to it over HTTP and signs you in through your browser, so there is no API key to create or paste.

Add mindmap.io to Claude Code

  1. In your terminal, add the server:

    claude mcp add --transport http mindmapio https://mindmap.io/mcp
  2. Start Claude Code, type /mcp, and pick mindmapio from the list of servers.

  3. In the browser tab that opens, sign in to mindmap.io, choose Full access or Read only, and approve.

Back in the terminal, /mcp shows mindmapio as connected, and its tools are available in the session.

You can also sign in without opening a session by running claude mcp login mindmapio.

Choose who gets the server

The --scope flag decides where Claude Code saves the server:

  • local is the default. The server is available to you in the current project only.
  • user makes it available to you in every project on this machine.
  • project saves it in a .mcp.json file at the root of the repo, so everyone who clones the repo gets it.

For the whole team, add it with project scope:

claude mcp add --transport http --scope project mindmapio https://mindmap.io/mcp

That writes this to .mcp.json:

{
  "mcpServers": {
    "mindmapio": {
      "type": "http",
      "url": "https://mindmap.io/mcp"
    }
  }
}

Commit the file. The file holds no key, so each teammate approves the server the first time Claude Code sees it and signs in to their own mindmap.io account from /mcp. Every map Claude Code builds lands in the account of the person who asked.

Already connected in the Claude app

If you added mindmap.io as a connector in Claude at claude.ai, under Customize then Connectors, Claude Code picks it up when you are logged in to Claude Code with the same claude.ai account. You don’t need to run claude mcp add as well.

The same connection works across Anthropic’s apps. The Claude app guide covers the web, desktop and phone, and Claude Duet uses the connectors on your Claude account.

Full access or read only

Read only lets Claude Code read the maps you already have. It cannot create, change, publish, spend or send anything, because a read-only connection is never shown the tools that write.

Full access also lets Claude Code build new maps, edit and delete them, ask questions inside a map, and publish a map as a public link.

Full access is the default. If you want to see how Claude Code uses your maps first, start with read only and sign in again with full access later. To disconnect, run claude mcp logout mindmapio, and Claude Code loses access to your account.

Ask Claude Code for a map

Say you are about to change how a service handles background jobs. From the repo, try a request like this:

Read this repo and build me a mindmap.io map of how background jobs work: one branch for each queue, a node for each worker under it, and a question under each worker about what happens when it fails.

The same works before you write code. Ask Claude Code to map three ways to build a feature with the trade-offs of each, then open the map and grow the branch you pick. With full access, Claude Code can also ask a question inside one of your maps and bring the answer back to the terminal, expand a branch into follow-up questions, and publish a finished map.

What it costs

A question Claude Code asks inside one of your maps uses the same credits as asking it yourself in the app, from the same balance. When the balance runs out, Claude Code tells you. Reading your maps is free.

Agents that cannot sign in through a browser

The remote server at https://mindmap.io/mcp signs you in through a browser and does not take an API key. For a CI job or an agent that can only send a fixed key, use a personal access token instead; the agent install guide in the links below covers it.