Mindmap MCP Server
Convert Markdown content into interactive markmap-based mindmaps (HTML or saved file).
Add to your client
Copy the config for your MCP client and paste it into its config file.
uvx mindmap-mcp-serverPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mindmap-mcp-server": {
"command": "uvx",
"args": [
"mindmap-mcp-server",
"--return-type",
"filePath"
]
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js installed (required when running via the python or uvx commands)
- Python with uvx/pip, or Docker if using the container method
About Mindmap MCP Server
Mindmap MCP Server exposes a tool for converting Markdown into interactive mindmap HTML built on the markmap-cli library. Output can be returned as full HTML content for preview in an AI client artifact, or written to a file with the path returned (saving tokens). It runs over stdio and works with any MCP-compatible client such as Claude Desktop. Installation is supported via pip/uvx (requires Node.js), a local Python file, or a published Docker image. The Docker container documents two named tools (markdown-to-mindmap-content and markdown-to-mindmap-file); the pip/uvx and python variants use a --return-type flag (html or filePath) to control output.
Tools & capabilities (2)
markdown-to-mindmap-contentConverts Markdown to an HTML mind map and returns the entire HTML content. Parameters: markdown (string, required) — the Markdown content to convert; toolbar (boolean, optional, default true) — whether to show the toolbar. Best for simple mind maps where HTML content size isn't a concern; previewable as an artifact in the AI client. (Documented for the Docker container.)
markdown-to-mindmap-fileConverts Markdown to an HTML mind map and saves it to a file in the mounted directory, returning the file path. Parameters: markdown (string, required) — the Markdown content to convert; filename (string, optional, default auto-generated timestamp name); toolbar (boolean, optional, default true). Best for complex mind maps or to save tokens for later use. (Documented for the Docker container.)
When to use it
- Turn a Markdown outline (e.g. a project plan) into an interactive mindmap previewable in your AI client's artifact
- Save a generated mindmap as an HTML file and open it in a browser to conserve tokens
- Have the assistant brainstorm a topic and render it as a mindmap, then open the file via a terminal MCP server
Security notes
When using the Docker method, you must mount a host directory to /output (e.g. -v /path/to/output/folder:/output) so generated mindmap files are written to a location you control. Docker needs permission to access that directory.
Mindmap MCP Server FAQ
What return types are supported?
Two: html returns the entire HTML content of the mindmap (preview in your AI client's artifact), and filePath saves the mindmap to a file and returns the path, which saves tokens. With pip/uvx/python you select this via the --return-type flag; the Docker container exposes them as separate tools.
Does it require Node.js?
Yes. When running via the python or uvx commands, Node.js must be installed because the server uses the markmap-cli library.
What should Windows users do if npx has issues?
The README recommends the Docker method for Windows users experiencing issues, or alternatively using the VS Code 'Markmap' extension as a simpler solution.
Alternatives to Mindmap MCP Server
Compare all alternatives →
Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.
Create, read, and modify Excel workbooks with your AI agent — no Microsoft Excel required.
Official Notion server to read, search, create, and update pages and databases in your workspace.