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
-
Open
~/.hermes/config.yamland add the server undermcp_servers:mcp_servers: mindmap: url: "https://mindmap.io/mcp" auth: oauthIf your file already has an
mcp_serverssection, add themindmapentry inside it. -
From a fresh terminal, sign in:
hermes mcp login mindmap -
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.