apeyroux/mcp-xmind
If you are the rightful owner of mcp-xmind and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
A Model Context Protocol server for analyzing and querying XMind mind maps, providing capabilities for searching, extracting, and analyzing content from XMind files.
MCP XMind Server
A Model Context Protocol server for reading, creating and querying XMind mind maps. This tool provides powerful capabilities for searching, extracting, analyzing and generating XMind files.
Features
Reading
- Parse complete mind map structure (multi-sheet)
- Smart fuzzy search across mind maps
- Task management and tracking (to-do + planned tasks)
- Hierarchical content navigation
- Link and reference extraction (external URLs + internal xmind:# links)
- Multi-file analysis
- Label, callout, boundary and summary support
- Directory scanning
Writing
- Create XMind files from structured JSON
- Nested topics with notes (plain text + HTML formatting)
- Labels, markers, callouts, boundaries, summaries
- Relationships between topics (by title)
- Internal links between topics across sheets (
linkToTopic) - Simple to-do tasks (checkbox)
- Planned tasks with Gantt support (dates, progress, priority, duration, dependencies)
- Predefined themes (default, business, dark, simple)
- Layout structures (clockwise, logic.right, org-chart, fishbone, timeline, etc.)
- Overwrite protection
Security
- Optionally restricts access to specified directories (if none provided, any path is allowed)
- Path normalization and validation
- Error handling for invalid access attempts
Installation
npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node
Usage
Starting the Server
node dist/index.js <allowed-directory> [additional-directories...]
Available Tools
Reading Tools
- read_xmind - Parse and extract complete mind map structure
- list_xmind_directory - Recursively scan for XMind files
- read_multiple_xmind_files - Process multiple files simultaneously
- search_xmind_files - Search files by name or content
- extract_node - Smart fuzzy path matching with ranked results
- extract_node_by_id - Direct node access by ID
- search_nodes - Multi-criteria search (title, notes, labels, callouts, tasks)
Writing Tools
- create_xmind - Create XMind files from structured data
Examples
Read a Mind Map
{
"name": "read_xmind",
"arguments": {
"path": "/path/to/file.xmind"
}
}
Search for Nodes
{
"name": "search_nodes",
"arguments": {
"path": "/path/to/file.xmind",
"query": "project",
"searchIn": ["title", "notes"],
"caseSensitive": false
}
}
Create a Mind Map with Planned Tasks
{
"name": "create_xmind",
"arguments": {
"path": "/path/to/output.xmind",
"sheets": [{
"title": "Project Plan",
"theme": "business",
"rootTopic": {
"title": "Deployment",
"children": [
{
"title": "Analysis",
"durationDays": 3,
"progress": 0,
"priority": 1
},
{
"title": "Development",
"durationDays": 5,
"progress": 0,
"dependencies": [{"targetTitle": "Analysis", "type": "FS"}]
}
]
}
}]
}
}
Create Multi-Sheet with Internal Links
{
"name": "create_xmind",
"arguments": {
"path": "/path/to/output.xmind",
"sheets": [
{
"title": "Overview",
"rootTopic": {
"title": "Project",
"linkToTopic": "Details Root",
"children": [{"title": "Phase 1"}, {"title": "Phase 2"}]
}
},
{
"title": "Details",
"rootTopic": {
"title": "Details Root",
"linkToTopic": "Project",
"notes": {"plain": "Detailed view", "html": "<p><strong>Detailed</strong> view</p>"}
}
}
]
}
}
Configuration
Claude Desktop
Add the following to your claude_desktop_config.json (on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
Using npx (recommended)
{
"mcpServers": {
"xmind": {
"command": "npx",
"args": [
"-y",
"@41px/mcp-xmind",
"/path/to/your/xmind/files"
]
}
}
}
Using a local build
{
"mcpServers": {
"xmind": {
"command": "node",
"args": [
"/path/to/mcp-xmind/dist/index.js",
"/path/to/your/xmind/files"
]
}
}
}
Restart Claude Desktop after editing the configuration.
Skill (Claude Desktop)
A standalone skill is available for creating XMind files without the MCP server. Unlike the MCP server which provides both reading and writing tools, the skill only supports creation.
Build the skill ZIP:
cd skills/xmind && zip -r xmind-skill.zip SKILL.md scripts/
Install: Open Claude Desktop > Settings > Capabilities > Skills > Upload xmind-skill.zip.
The skill script has zero npm dependencies (uses Node.js built-ins only), so it works in the Claude Desktop sandbox.
Capabilities: nested topics, plain & HTML notes (<strong>, <u>, lists), labels, markers, callouts, boundaries, summaries, relationships between topics, internal links across sheets, layout structures (org-chart, fishbone, timeline…), themes (business, dark, simple), simple tasks (todo/done), and planned tasks with Gantt support (dates, duration, progress, priority, dependencies).
Claude Code (CLI)
MCP server:
claude mcp add xmind -- npx -y @41px/mcp-xmind /path/to/your/xmind/files
Skill (création uniquement): copier ou lier le dossier skill dans .claude/skills/ du projet ou ~/.claude/skills/ pour tous les projets :
# Projet uniquement
ln -s /path/to/mcp-xmind/skills/xmind .claude/skills/xmind
# Tous les projets
ln -s /path/to/mcp-xmind/skills/xmind ~/.claude/skills/xmind
Development
Building
npm run build
Testing
npm test
MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js /path/to/xmind/files
