mindmap-mcp-server — Claude Code MCP server: how to install
Saves session context locally and hands it off between AI coding tools. Lets you resume work across different editors without explaining projects again.
claude mcp add mindmap-mcp-server -- npx -y @ravi-labs/mindmap-mcp-serverWhat mindmap-mcp-server does
The server acts as a shared local memory layer for desktop coding assistants. Once a task concludes in one editor, the model captures state to plain files in ~/.mindmap/. You can redirect this storage using the MINDMAP_DIR environment variable. Everything stays on the local disk.
Unused notes gradually cool down into single-line traces rather than disappearing. Picking up a topic again restores it to active memory. Users can organize records into collections like goals or paused tasks, which shields them from cooling down. Browser-based interfaces such as ChatGPT cannot reach this server because it exposes no external public endpoint.
Running the installer wires a SessionEnd hook directly into Claude Code. The process starts over stdio using npx.
What it helps with
- transfer conversation context between separate AI editors
- resume an unfinished task right where you paused
- prevent important project decisions from decaying
- share local session notes without third-party cloud sync
Example prompts for the agent
- Save this session to mind map
- Resume my work on the database migration
- Show unfinished projects stored in memory
How to install mindmap-mcp-server
Platform CLI
claude mcp add mindmap-mcp-server -- npx -y @ravi-labs/mindmap-mcp-serverPlatform CLI
codex mcp add mindmap-mcp-server -- npx -y @ravi-labs/mindmap-mcp-serverConfig file
{
"mcpServers": {
"mindmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@ravi-labs/mindmap-mcp-server"
]
}
}
}Config file
{
"servers": {
"mindmap-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ravi-labs/mindmap-mcp-server"
]
}
}
}Platform CLI
gemini mcp add mindmap-mcp-server npx -y @ravi-labs/mindmap-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mindmap-mcp-server
How to install mindmap-mcp-server in Claude Code?
Run claude mcp add mindmap-mcp-server -- npx -y @ravi-labs/mindmap-mcp-server. After restarting the client, the memory tools will appear automatically.
Where does the server keep saved memories?
Files live locally in ~/.mindmap/. You can change the target folder by exporting the MINDMAP_DIR environment variable.
Does this server connect to web-based ChatGPT?
No, browser clients cannot connect. It operates strictly on your local machine without exposing a public endpoint.
