mapmind-mcp-server
v0.1.9
Published
Official MCP server for MindFlow AI — expose your mindmaps as a knowledge surface to Claude, Cursor, Windsurf, Gemini CLI, and any MCP-compatible agent.
Maintainers
Readme
Turn your mindmaps into an intelligent, queryable knowledge surface! This server exposes your MindFlow mindmaps, node research, and generated quizzes directly to MCP-compatible AI agents like Claude Desktop, Cursor, and Windsurf.
Instead of switching tabs, your AI assistant can now read, summarize, and explore the research you've built visually in MapMind.
✨ Features
- 🧠 Contextual Research: Give your AI direct access to the nodes and deep research from your mindmaps.
- 🚀 Zero-Config Setup: Simply provide your MapMind API key, and your AI is securely connected.
- 🛠️ Rich Toolset:
list_mindmaps,get_mindmap,research_node,create_quiz, and more! - ⚡ Dual Transports: Supports standard
stdiofor local IDEs and Streamable HTTP for cloud integrations.
🚀 Quick Start
1. Get Your API Key
Generate an MCP API Key securely inside your MindFlow Settings: 👉 Settings > Integrations > Agent Integrations (MCP)
2. Connect Your Agent
🤖 Cursor / Windsurf
Go to MCP Settings and add a new stdio server:
- Command:
npx -y mapmind-mcp-server - Environment variables:
MAPMIND_API_KEY=mfk_YOUR_KEY_HERE(required)MAPMIND_BASE_URL=https://mapmind-psi.vercel.app(optional — defaults tohttps://mindflow.app)
Or edit .cursor/mcp.json directly:
{
"mcpServers": {
"mapmind": {
"command": "npx",
"args": ["-y", "mapmind-mcp-server"],
"env": {
"MAPMIND_API_KEY": "mfk_YOUR_KEY_HERE",
"MAPMIND_BASE_URL": "https://mapmind-psi.vercel.app"
}
}
}
}🧠 Claude Desktop
Edit your ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %AppData%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mapmind": {
"command": "npx",
"args": ["-y", "mapmind-mcp-server"],
"env": {
"MAPMIND_API_KEY": "mfk_YOUR_KEY_HERE",
"MAPMIND_BASE_URL": "https://mapmind-psi.vercel.app"
}
}
}
}🛠️ Available Tools
| Tool | Description |
|---|---|
| list_mindmaps | Get a paginated list of your recent mindmaps. |
| get_mindmap | Fetch the full graph (nodes, edges) of a specific mindmap. |
| get_node_research | Retrieve deep research data for a specific node. |
| research_node | Trigger background LLM research for an empty node. |
| create_quiz | Automatically generate a learning quiz based on a node's content. |
| export_to_notion | Push a branch of your mindmap directly to Notion. |
📚 Resources & Prompts
- Resources: Agents can directly read
mindmap://{id}andnode://{mindmapId}/{nodeId}URIs. - Prompts: Includes
summarize-mindmapfor instant executive summaries andnext-watchfor personalized YouTube recommendations based on your map.
Built with ❤️ by the MindFlow AI Team.
