XMind

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:

1npx -y @smithery/cli install @41px/mcp-xmind --client claude

Manual Installation

1npm install @modelcontextprotocol/sdk adm-zip zod
2npm install --save-dev typescript @types/node

Usage

Starting the Server

1node dist/index.js <allowed-directory> [additional-directories...]

Available Tools

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

1{
2    "name": "search_nodes",
3    "arguments": {
4        "path": "/path/to/file.xmind",
5        "query": "project",
6        "searchIn": ["title", "notes"],
7        "caseSensitive": false
8    }
9}

Extract Node

1{
2    "name": "extract_node",
3    "arguments": {
4        "path": "/path/to/file.xmind",
5        "searchQuery": "Feature > API"
6    }
7}

List Tasks

1{
2    "name": "get_todo_tasks",
3    "arguments": {
4        "path": "/path/to/file.xmind"
5    }
6}

Configuration

Development Configuration

Example claude_desktop_config.json for development:

1{
2  "xmind": {
3    "command": "node",
4    "args": [
5      "/Users/alex/Src/mcp-xmind/dist/index.js",
6      "/Users/alex/XMind"
7    ]
8  }
9}

Production Configuration

Example claude_desktop_config.json for production using npmjs:

1{
2  "xmind": {
3    "command": "npx",
4    "args": [
5      "-y",
6      "@41px/mcp-xmind",
7      "/Users/alex/XMind"
8    ]
9  }
10}

Security

Only allows access to specified directories
Path normalization and validation
Error handling for invalid access attempts

Development

Building

1npm run build

Type Checking

1npm run type-check

MCP Inspector

1npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind

Contents