MCP XMind Server
A Model Context Protocol server for analyzing and querying XMind mind maps. This tool provides powerful capabilities for searching, extracting, and analyzing content from XMind files.
Features
- 🔍 Smart fuzzy search across mind maps
- 📝 Task management and tracking
- 🌲 Hierarchical content navigation
- 🔗 Link and reference extraction
- 📊 Multi-file analysis
- 🏷️ Label and tag support
- 📂 Directory scanning
- 🔒 Secure directory access
Installation
Installing via Smithery
To install XMind Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @41px/mcp-xmind --client claude
Manual 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...]
- read_xmind
- Parse and analyze XMind files
- Extract complete mind map structure
- get_todo_tasks
- Extract and analyze TODO tasks
- Include task context and hierarchy
- list_xmind_directory
- Recursively scan for XMind files
- Filter and organize results
- read_multiple_xmind_files
- Process multiple files simultaneously
- Compare and analyze across files
- search_xmind_files
- Search files by name patterns
- Recursive directory scanning
- extract_node
- Smart fuzzy path matching
- Ranked search results
- Complete subtree extraction
- extract_node_by_id
- Direct node access by ID
- Fast and precise retrieval
- search_nodes
- Multi-criteria content search
- Configurable search fields
Examples
Search for Nodes
{
"name": "search_nodes",
"arguments": {
"path": "/path/to/file.xmind",
"query": "project",
"searchIn": ["title", "notes"],
"caseSensitive": false
}
}
{
"name": "extract_node",
"arguments": {
"path": "/path/to/file.xmind",
"searchQuery": "Feature > API"
}
}
List Tasks
{
"name": "get_todo_tasks",
"arguments": {
"path": "/path/to/file.xmind"
}
}
Configuration
Development Configuration
Example claude_desktop_config.json for development:
{
"xmind": {
"command": "node",
"args": [
"/Users/alex/Src/mcp-xmind/dist/index.js",
"/Users/alex/XMind"
]
}
}
Production Configuration
Example claude_desktop_config.json for production using npmjs:
{
"xmind": {
"command": "npx",
"args": [
"-y",
"@41px/mcp-xmind",
"/Users/alex/XMind"
]
}
}
Security
- Only allows access to specified directories
- Path normalization and validation
- Error handling for invalid access attempts
Development
Building
Type Checking
MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind