What is XMind

MCP XMind Server is a Model Context Protocol server designed for the analysis and querying of XMind mind maps. It provides versatile tools for searching, extracting, and analyzing content from XMind files, enhancing the way users interact with their mind maps.

Use cases

The server can be used for various purposes including managing tasks within mind maps, analyzing multiple mind map files, performing hierarchical navigation of content, and extracting specific nodes or tasks based on user-defined criteria.

How to use

To use the server, start by installing it through Smithery or manually. You can run the server with a command that specifies allowed directories. Various tools are available that allow users to read and analyze XMind files, extract tasks or nodes, and perform searches across documents.

Key features

Key features include smart fuzzy search capabilities, hierarchical content navigation, task management, link and reference extraction, support for labels and tags, directory scanning, and secure access to specified directories.

Where to use

MCP XMind Server can be utilized in contexts where mind mapping and project management are essential, such as in project planning, brainstorming sessions, or educational environments where visual information organization is beneficial.

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

Available Tools

1. read_xmind

   • Parse and analyze XMind files
   • Extract complete mind map structure

2. get_todo_tasks

   • Extract and analyze TODO tasks
   • Include task context and hierarchy

3. list_xmind_directory

   • Recursively scan for XMind files
   • Filter and organize results

4. read_multiple_xmind_files

   • Process multiple files simultaneously
   • Compare and analyze across files

5. search_xmind_files

   • Search files by name patterns
   • Recursive directory scanning

6. extract_node

   • Smart fuzzy path matching
   • Ranked search results
   • Complete subtree extraction

7. extract_node_by_id

   • Direct node access by ID
   • Fast and precise retrieval

8. 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
  }
}

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