# Markmap MCP Server (MCP server)

> Markmap MCP Server is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. An MCP server for converting Markdown to interactive mind maps with export support (PNG/JPG/SVG). It has 289 GitHub stars, is released under the MIT license and runs locally with npx -y @jinzcdev/markmap-mcp-server.

Markmap MCP Server is based on the Model Context Protocol (MCP). It converts Markdown into interactive mind maps using markmap, and can optionally export PNG / JPG / SVG on the server for Agent-friendly delivery. Generation runs locally — no third-party API keys required.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/jinzcdev/markmap-mcp-server |
| GitHub stars | 289 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @jinzcdev/markmap-mcp-server |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v0.2.0 (Aug 4, 2026) |
| Last commit | Aug 4, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "your-value",
        "MARKMAP_OPEN": "your-value",
        "MARKMAP_RETURN_MODE": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env MARKMAP_DIR=your-value --env MARKMAP_OPEN=your-value --env MARKMAP_RETURN_MODE=your-value --transport stdio markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server
```

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

```json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "your-value",
        "MARKMAP_OPEN": "your-value",
        "MARKMAP_RETURN_MODE": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "servers": {
    "markmap-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "your-value",
        "MARKMAP_OPEN": "your-value",
        "MARKMAP_RETURN_MODE": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `MARKMAP_DIR`: Shown in the README's example configuration.
- `MARKMAP_OPEN`: Shown in the README's example configuration.
- `MARKMAP_RETURN_MODE`: Shown in the README's example configuration.

## Tools

- `markdown_to_mindmap`: Convert Markdown into an interactive mind map (and optionally an image).
- `markdown`: string
- `format`: html \
- `filename`: string
- `open`: boolean
- `list_mindmaps`: List recent generated files in the output directory (newest first).
- `limit`: number
- `get_mindmap`: Retrieve a generated mind map file by its absolute path. Path must stay inside the configured output directory (path…
- `cleanup_mindmaps`: Delete old (or all) generated mind map files.
- `topic`: string

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/markmap-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.