Set up mindmap.io MCP in Hermes Agent: let Hermes build your mindmaps

Add the mindmap.io MCP server to Hermes Agent, and it can build maps in your account and read them back.

After this guide, Hermes Agent, the open-source agent from Nous Research, can build maps in your mindmap.io account and read them back. Ask it to map a topic and the map appears in your account: a root idea, questions under it, and an answer under each question. You can open it in the browser, keep growing branches, and send someone the link.

mindmap.io runs a remote MCP server at https://mindmap.io/mcp. Hermes registers itself with the server when you sign in, so there is no client ID, client secret or API key to set up.

Add mindmap.io to Hermes Agent

  1. Open ~/.hermes/config.yaml and add the server under mcp_servers:

    mcp_servers:
      mindmap:
        url: "https://mindmap.io/mcp"
        auth: oauth

    If your file already has an mcp_servers section, add the mindmap entry inside it.

  2. From a fresh terminal, sign in:

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

The tab hands control back to the terminal, and Hermes saves your sign-in in ~/.hermes/mcp-tokens/mindmap.json.

If you prefer a command to editing YAML, hermes mcp add writes the same entry:

hermes mcp add mindmap --url https://mindmap.io/mcp --auth oauth

Check the connection

Test it from the terminal:

hermes mcp test mindmap

If a Hermes session was already running when you added the server, type /reload-mcp in it to load the mindmap.io tools without restarting. Hermes warns that a reload rebuilds the tool set, which resets the prompt cache for that session.

Sign in on a machine with no browser

On a server you reach over SSH, Hermes cannot open a browser for you. It prints the sign-in link instead. Open the link on any device, approve, then copy the address the browser lands on and paste it back into the terminal.

How Hermes signs in without a client ID

Hermes first identifies itself with a published client ID metadata document, and falls back to registering itself as a new client when a server does not support that. mindmap.io supports both, so the auth: oauth line is the only sign-in setting you need. You can leave the optional oauth: block in Hermes’ config out.

Full access or read only

Read only lets Hermes 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 Hermes 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 Hermes uses your maps first, start with read only, then run hermes mcp login mindmap again and choose full access.

Ask Hermes for a map

Try a request like this:

Research how heat pumps work in cold climates, then build me a mindmap.io map with a branch for each part of the system and a question under each branch.

With full access, Hermes can also ask a question inside one of your maps and bring the answer into the session, expand a branch into follow-up questions, and publish a finished map.

What it costs

A question Hermes 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, Hermes 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 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.