Mindmap MCP Server

Ever lose the thread of a discussion across Claude Code, Claude Desktop, and your other AI tools? Mind Map is a small, local-first MCP server that acts as a shared memory layer across all your local MCP clients. Its 29 documented tools cover mindmap, persona, resume, import.

People connecting memory tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-06 · ★ 4 · #172 OF 259 MAINTAINED MEMORY · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Mindmap MCP Server

before you install - you'll need

Set MINDMAP_DIR, ANTHROPIC_API_KEY before connecting.

Claude Code

claude mcp add ravi-labs-mindmap-mcp-server -- npx -y @ravi-labs/mindmap-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ravi-labs-mindmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ravi-labs/mindmap-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @ravi-labs/mindmap-mcp-server - published under the repo owner's npm scope (@ravi-labs)

registry namespace io.github.ravi-labs is GitHub-verified and matches the repo owner

03 · What Mindmap MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

The 29 tools it gives your agent

Extracted from the project's README - what mindmap-mcp-server lets an agent do.

mindmap_capture
- Silently save a context summary (the effortless half of the loop).
mindmap_resume
- Find + return the best context for a topic; promotes on reuse. Also a launcher: pass collection to resume out of e.g. "Unfinished projects".
mindmap_resume_options
- List distinct candidate topics (with workspace) so the user can pick which to resume.
mindmap_import
- On-demand session sync - "update mind map with my recent work".
mindmap_organize
- File memories into collections - "add this to my Goals", "park this".
mindmap_collections
- View collections; opening one shows workspace + where-you-left-off per item.
mindmap_curate
- Auto-organize: scan everything, propose collections (unfinished projects, goals, decisions, parked). Preview-first.
mindmap_brainstorm
- Brainstorm a topic with your memory - loads prior idea-threads so ideas continue across tools.
mindmap_search
- Read-only search across every tier and tool.
mindmap_list
- Browse memories with filters.
mindmap_get
- Fetch one memory's full content.
mindmap_transcript
- Reconstruct the full original conversation for a memory (Claude Code / Cursor / Copilot).
show all 29 tools
mindmap_promote
- Explicitly bless a memory as trusted (→ hot).
mindmap_update
- Trim / edit / retag - the human curation moment.
mindmap_link
- Connect related threads (the lightweight "map").
mindmap_prune
- Run the consolidation pass on demand (dry_run to preview).
mindmap_forget
- Soft-archive to a trace, or hard delete.
mindmap_health
- Gamified cleanliness score (opt-in).
mindmap_tidy
- Batch of stalest memories to keep / trim / forget.
mindmap_config
- View / change decay windows and toggles.
mindmap_persona
- Read your persona - apply it at session start to stop re-asking.
mindmap_persona_set
- Record a durable preference (stack/style/constraints…).
mindmap_persona_forget
- Mute or delete a persona fact.
mindmap_persona_learn
- Infer persona facts from your memories (LLM-assisted if configured).
mindmap_persona_sync
- Write your persona into your tools' native config files.
mindmap_llm
- Configure the optional BYO-key LLM (provider/model; key stays in your env).
mindmap_audit
- Glass-box ledger: provenance, trust, and decay forecast for every memory.
mindmap_passport_export
- Export all memories + persona to one portable file.
mindmap_passport_import
- Import a passport, or a ChatGPT / Claude.ai data export.

Latest releases

v0.6.0 · 2026-07-06

Organize your memory, then use it as a launcher. · What's new · Collections - your organization layer · Group memories however you think: 🎯 Goals, 🅿️ Parking Lot, ✅ Decisions, or anything you name - on top of the…

v0.5.0 · 2026-06-30

A big batch: better search, restarting whole topics, privacy, and observability. · Better search · BM25 relevance (IDF, length-normalization, title boost) replaces token-overlap. · Optional hybrid search (BM25 +…

v0.3.2 · 2026-06-11

Hardens the ChatGPT & Claude.ai data-export importers for real export formats. · passport import-chatgpt: skips hidden system / custom-instruction messages and tool/system roles; handles multimodal_text parts that mix…

04 · Who maintains Mindmap MCP Server

mindmap-mcp-server is maintained by ravi-labs. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

category
memory - ranked #172 of 259 actively-maintained memory servers as of 2026-08-25.
release cadence
7 releases in the last 90 days (latest 2026-07-06)
registry
io.github.ravi-labs/mindmap-mcp-server (active, first published 2026-06-12 · 2 versions)
packages
npm:@ravi-labs/mindmap-mcp-server

06 · Mindmap MCP Server FAQ

Is Mindmap MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-06 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can Mindmap MCP Server do?

Its README documents 29 tools, including mindmap_capture, mindmap_resume, mindmap_resume_options.

How do I install Mindmap MCP Server?

Run `npx -y @ravi-labs/mindmap-mcp-server`. The README documents 2 environment variables (MINDMAP_DIR, ANTHROPIC_API_KEY) to set first. Set MINDMAP_DIR, ANTHROPIC_API_KEY before connecting. You can also paste the ready-made client config above.

Does Mindmap MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mindmap MCP Server

Pairs well with

Servers that cover what Mindmap MCP Server doesn't - only shown when the pairing reason fits the companion.

  1. Server Filesystem → filesystem companion filesystem · ★ 38,704
  2. X402 List MCP → filesystem companion filesystem · ★ 58