mcp xmind

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...]

Available Tools

1. read_xmind
2. Parse and analyze XMind files

3. Extract complete mind map structure

4. get_todo_tasks

5. Extract and analyze TODO tasks

6. Include task context and hierarchy

7. list_xmind_directory

8. Recursively scan for XMind files

9. Filter and organize results

10. read_multiple_xmind_files

11. Process multiple files simultaneously

12. Compare and analyze across files

13. search_xmind_files

14. Search files by name patterns

15. Recursive directory scanning

16. extract_node

17. Smart fuzzy path matching
18. Ranked search results

19. Complete subtree extraction

20. extract_node_by_id

21. Direct node access by ID

22. Fast and precise retrieval

23. search_nodes

24. Multi-criteria content search
25. Configurable search fields

Examples

Search for Nodes

{
    "name": "search_nodes",
    "arguments": {
        "path": "/path/to/file.xmind",
        "query": "project",
        "searchIn": ["title", "notes"],
        "caseSensitive": false
    }
}

Extract Node

{
    "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

npm run build

Type Checking

npm run type-check

MCP Inspector

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