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.
- 🔍 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
npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node
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
{
"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"
}
}
{
"name": "get_todo_tasks",
"arguments": {
"path": "/path/to/file.xmind"
}
}
Example claude_desktop_config.json
for development:
{
"xmind": {
"command": "node",
"args": [
"/Users/alex/Src/mcp-xmind/dist/index.js",
"/Users/alex/XMind"
]
}
}
Example claude_desktop_config.json
for production using npmjs:
{
"xmind": {
"command": "npx",
"args": [
"-y",
"@41px/mcp-xmind",
"/Users/alex/XMind"
]
}
}
- Only allows access to specified directories
- Path normalization and validation
- Error handling for invalid access attempts
npm run build
npm run type-check
npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind