Mindlm MCP
Turns text, web pages and PDFs into offline HTML mind maps, no API key needed
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 2 days ago
About Mindlm MCP
Mindlm MCP is a free MCP server for productivity. It runs locally on your machine and is started by your AI client.
Each map ends up as a single HTML file of roughly 340 KB, with d3, markmap-view and the toolbar inlined, so it opens by double-click with no network. You can pan, zoom and fold nodes. Raw HTML from a source page is never rendered, so text scraped from a hostile site cannot inject script into the file.
Over MCP the default mode is client: the server returns a rule-based draft outline, the cleaned source text and instructions, and your own model rewrites the outline before calling the export tool. A heuristic mode (the CLI default) uses rules only, with headings becoming branches and ranked sentences becoming leaves. An llm mode runs only if you set ANTHROPIC_API_KEY or OPENAI_API_KEY, optionally with an OpenAI-compatible base URL. There is no hosted backend and no telemetry.
It needs Node 22.12 or newer and runs through npx. Private and loopback addresses are blocked for URL fetching unless you set MINDMAP_ALLOW_PRIVATE_HOSTS. The same package doubles as a command-line tool with text, url, pdf, export, serve and doctor commands.
Install
Run in a terminal
claude mcp add mindlm-mcp --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y mindlm-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mindlm-mcp": {
"command": "npx",
"args": [
"-y",
"mindlm-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mindlm-mcp": {
"command": "npx",
"args": [
"-y",
"mindlm-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mindlm-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mindlm-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mindlm-mcp": {
"command": "npx",
"args": [
"-y",
"mindlm-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mindlm-mcp": {
"command": "npx",
"args": [
"-y",
"mindlm-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Configuration
MINDMAP_OUTPUT_DIRDirectory for exported HTML mind maps. Defaults to ./mindmaps.ANTHROPIC_API_KEYOptional. Set it to let the server write outlines with a model itself instead of handing a draft back to the client.OPENAI_API_KEYOptional. Same as ANTHROPIC_API_KEY, for any OpenAI-compatible endpoint.OPENAI_BASE_URLOptional. OpenAI-compatible endpoint. Defaults to https://api.openai.com/v1.MINDMAP_LLM_MODELOptional. Model name. Required when using an OpenAI-compatible endpoint.MINDMAP_ALLOW_PRIVATE_HOSTSOptional. Set to true to let url_to_mindmap reach loopback and private addresses. Off by default.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- text_to_mindmap
- Builds a Markdown outline from text, notes or a transcript.
- url_to_mindmap
- Outlines the body of an http(s) page or a PDF served over http.
- pdf_to_mindmap
- Outlines a local PDF with a text layer, using bookmarks when present.
- export_mindmap
- Renders a Markdown outline as a standalone HTML mind map.
What it does
- Four MCP tools
- text_to_mindmap, url_to_mindmap, pdf_to_mindmap and export_mindmap.
- Standalone HTML export
- One offline file per map with every script inlined.
- Three generation modes
- Client, heuristic or llm, chosen per call or by environment.
- PDF bookmarks
- Local PDFs with a text layer are outlined from their bookmarks when present.
- Tunable depth
- maxDepth (2 to 6) and maxChildren (3 to 15) control the outline size.
- Command-line use
- The same functions run as mindlm-mcp commands for batch work.
Good for
- Turn meeting notes or a transcript into a foldable map
- Outline a long article from its URL before reading it
- Map a PDF report using its bookmarks as the skeleton
- Process a folder of documents in a script with deterministic output
Pricing
Free
No API key or account needed; optional model keys are your own
Prices change. Check qingchejun.github.io before you buy.
Mindlm MCP FAQ
Do I need an API key?
No. Over MCP your client's model writes the outline; keys are only used if you choose llm mode.
What does it need to run?
Node 22.12 or newer, run on demand with npx -y mindlm-mcp serve.
Does the map need internet to open?
No. Scripts are inlined, though you can pass --no-offline to link CDN assets instead.
Can it read private network URLs?
Not by default; set MINDMAP_ALLOW_PRIVATE_HOSTS to true to allow loopback and private addresses.
Is Mindlm MCP free?
Yes. Mindlm MCP is free to use.
How do I add Mindlm MCP to Claude Code?
Run this command in your terminal: claude mcp add mindlm-mcp --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y mindlm-mcp
What are the best alternatives to Mindlm MCP?
The closest alternatives to Mindlm MCP are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.
Alternatives to Mindlm MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents