# Mindlm MCP

> Mindlm MCP is a free MCP server for productivity. Turns text, web pages and PDFs into offline HTML mind maps, no API key needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://qingchejun.github.io/mindlm-io/
- **Repository:** https://github.com/qingchejun/mindlm-io
- **MCP Registry name:** io.github.qingchejun/mindlm-mcp
- **Categories:** productivity, files and documents
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mindlm-mcp --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y mindlm-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mindlm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mindlm-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mindlm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mindlm-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mindlm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mindlm-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mindlm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mindlm-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/mindlm-mcp
