XMind MCP Server

What does “XMind” MCP Server do?

The XMind MCP (Model Context Protocol) Server is a specialized tool that connects AI assistants to XMind mind map files, enabling seamless analysis and querying of mind maps. By acting as an interface between AI agents and XMind data, it allows developers and AI systems to perform advanced operations such as searching, extracting, and analyzing content from XMind files. This enhances development workflows by supporting tasks like smart fuzzy search, task management, hierarchical navigation, link extraction, and multi-file analysis. The server is particularly valuable for teams who need to automate the exploration, organization, and processing of knowledge stored in XMind formats, making it easier to surface relevant insights and interact with complex mind map structures programmatically.

List of Prompts

No explicit prompt templates are listed in the repository.

List of Resources

No specific MCP resources are defined in the repository documentation.

List of Tools

• read_xmind
  Parse and analyze XMind files, extracting the complete mind map structure.
• get_todo_tasks
  Extract and analyze TODO tasks, including their context and hierarchy within the mind map.
• list_xmind_directory
  Recursively scan directories for XMind files, with filtering and organization of results.
• read_multiple_xmind_files
  Process multiple XMind files simultaneously to compare and analyze content across files.
• search_xmind_files
  Search for XMind files by name patterns, supporting recursive directory scanning.
• extract_node
  Find and extract nodes using smart fuzzy path matching, with ranked search results and subtree extraction.
• extract_node_by_id
  Direct node access by unique ID, enabling fast and precise retrieval.
• search_nodes
  Perform multi-criteria content search with configurable search fields.

Use Cases of this MCP Server

• Project and Task Management
  Automate the extraction and analysis of TODO tasks from XMind mind maps, enabling streamlined task tracking and reporting for project management workflows.
• Knowledge Base Exploration
  Enable AI-powered navigation and searching across large mind map collections, helping users quickly find relevant concepts and hierarchical structures within their knowledge base.
• Multi-file Mind Map Analysis
  Analyze and compare data across multiple XMind files simultaneously, allowing for cross-project insights and more holistic understanding of organizational knowledge.
• Content Extraction and Reporting
  Extract specific nodes or entire subtrees from mind maps for reporting, documentation, or integration with other tools and dashboards.
• Directory Scanning and Organization
  Recursively scan directories to organize, index, and surface metadata about available XMind files, making it easier to manage mind map repositories.

How to set it up

Windsurf

1. Ensure you have Node.js installed.
2. Locate your Windsurf configuration file (e.g., windsurf.config.json).
3. Add the XMind MCP Server using the following JSON snippet under the mcpServers object:

   {
     "xmind": {
       "command": "npx",
       "args": [
         "-y",
         "@41px/mcp-xmind@latest",
         "/path/to/your/xmind-directory"
       ]
     }
   }
   

4. Save the configuration file and restart Windsurf.
5. Verify that the server is listed and accessible in Windsurf.

Securing API Keys

If your configuration requires authentication or environment variables, include an env section:

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind@latest",
      "/path/to/your/xmind-directory"
    ],
    "env": {
      "API_KEY": "${API_KEY}"
    }
  }
}

Claude

1. Install Node.js if not already present.
2. Open or create your claude_desktop_config.json.
3. Add the XMind MCP Server configuration:

   {
     "xmind": {
       "command": "npx",
       "args": [
         "-y",
         "@41px/mcp-xmind@latest",
         "/path/to/your/xmind-directory"
       ]
     }
   }
   

4. Save the file and restart Claude.
5. Confirm the server is running by checking the Claude desktop interface.

Securing API Keys

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind@latest",
      "/path/to/your/xmind-directory"
    ],
    "env": {
      "API_KEY": "${API_KEY}"
    }
  }
}

Cursor

1. Install Node.js.
2. Edit your Cursor configuration (e.g., cursor.config.json).
3. Add the XMind MCP Server under the appropriate section:

   {
     "xmind": {
       "command": "npx",
       "args": [
         "-y",
         "@41px/mcp-xmind@latest",
         "/path/to/your/xmind-directory"
       ]
     }
   }
   

4. Save changes and restart Cursor.
5. Check the MCP integration panel to confirm setup.

Securing API Keys

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind@latest",
      "/path/to/your/xmind-directory"
    ],
    "env": {
      "API_KEY": "${API_KEY}"
    }
  }
}

Cline

1. Ensure Node.js is installed.
2. Open your Cline configuration file (e.g., cline.config.json).
3. Insert the following configuration for the XMind MCP Server:

   {
     "xmind": {
       "command": "npx",
       "args": [
         "-y",
         "@41px/mcp-xmind@latest",
         "/path/to/your/xmind-directory"
       ]
     }
   }
   

4. Save and restart Cline.
5. Verify the server is operational within Cline’s interface.

Securing API Keys

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind@latest",
      "/path/to/your/xmind-directory"
    ],
    "env": {
      "API_KEY": "${API_KEY}"
    }
  }
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "xmind": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “xmind” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Support for Roots: Not specified
Support for Sampling: Not mentioned

Based on the available documentation, XMind MCP Server provides strong tool coverage and clear setup guidance, but lacks explicit details on prompt templates, resource primitives, and advanced MCP features like roots and sampling. Overall, it is practical for mind map analysis but not fully mature in the broader MCP ecosystem. My rating: 6/10.

MCP Score