Say you’re halfway through a migration in Codex and the plan has outgrown the terminal scrollback. Add the mindmap.io MCP server, and Codex writes that plan as a map in your mindmap.io account: a root idea, questions under it, and an answer under each question. You open the map in the browser to keep growing branches or to send someone the link.
Add mindmap.io from the CLI
-
Add the server:
codex mcp add mindmapio --url https://mindmap.io/mcp -
Sign in:
codex mcp login mindmapio -
In the browser tab that opens, sign in to mindmap.io, choose Full access or Read only, and approve.
-
Start Codex and type
/mcpto see mindmapio in the list of servers.
mindmap.io uses OAuth, so there is no API key to paste.
Add it in config.toml instead
The same server, written by hand in ~/.codex/config.toml:
[mcp_servers.mindmapio]
url = "https://mindmap.io/mcp"
Then run codex mcp login mindmapio to sign in.
The desktop app and the IDE extension
The Codex CLI, the IDE extension and the desktop app read one shared config. Add mindmap.io in any of them and the other two have it.
- Desktop app: open Settings, then MCP servers, click Add server, paste
https://mindmap.io/mcp, then click Authenticate. - IDE extension: open the gear menu, then MCP servers, and click Add server.
Codex Cloud tasks may not see the server. OpenAI’s MCP docs cover the CLI, the IDE extension and the desktop app (learn.chatgpt.com/docs/extend/mcp).
Full access or read only
Read only lets Codex read the maps you already have. A read-only connection never sees the tools that create, change, publish or spend, so Codex can’t call them.
Full access adds building new maps, editing and deleting them, asking questions inside a map, expanding a branch into follow-up questions, and publishing a map to a public link.
To switch, run codex mcp login mindmapio again and make the other choice.
Ask Codex for a map
Try a prompt like this in a repository:
Read this repo’s src folder and build me a mindmap.io map with a branch for each module and a question under each branch about what it depends on.
What it costs
Reading your maps costs nothing. A question Codex 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, mindmap.io says so in its reply to Codex. Plans and credits are on the pricing page.
ChatGPT on the same account
Codex keeps its own list of MCP servers. ChatGPT has a separate one under Plugins, and the ChatGPT guide covers adding mindmap.io there.