XMind Mind Map Analyzer MCP Server

Knowledge & MemoryTypeScript

Analyze and query XMind mind maps with powerful search and extraction capabilities

Available Tools

read_xmind

Parse and analyze XMind files to extract the complete mind map structure

get_todo_tasks

Extract and analyze TODO tasks from XMind files, including task context and hierarchy

list_xmind_directory

Recursively scan for XMind files in a directory, with filtering and organization options

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 with recursive directory scanning

extract_node

Extract nodes using smart fuzzy path matching with ranked search results and complete subtree extraction

extract_node_by_id

Directly access and retrieve nodes by their ID for fast and precise retrieval

search_nodes

Perform multi-criteria content search across nodes with configurable search fields

The XMind Mind Map Analyzer provides a comprehensive set of tools for working with XMind files through AI assistants. It enables powerful capabilities for searching, extracting, and analyzing content from XMind mind maps, making it easier to navigate complex information hierarchies and manage tasks. With features like smart fuzzy search, hierarchical content navigation, and multi-file analysis, this tool transforms how you interact with your mind maps. Whether you're tracking tasks, organizing projects, or exploring complex knowledge structures, the XMind Analyzer helps you extract meaningful insights from your mind maps without manual searching.

Overview

The XMind Mind Map Analyzer is a Model Context Protocol (MCP) server that provides AI assistants with the ability to analyze and query XMind mind map files. This tool is particularly useful for knowledge workers, project managers, and anyone who uses mind maps to organize information.

Installation

You can install the XMind Mind Map Analyzer in two ways:

Option 1: Install via Smithery (Recommended)

If you're using Claude Desktop, you can install automatically via Smithery:

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

Option 2: Manual Installation

Install the required dependencies:

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

Add the configuration to your AI assistant's config file:

For Claude Desktop, create or modify your claude_desktop_config.json:

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

Replace /path/to/your/xmind/files with the directory containing your XMind files.

Usage

Once installed, the XMind Mind Map Analyzer will be available to your AI assistant. You can ask your assistant to:

Search for specific content within your mind maps
Extract nodes and subtrees from your mind maps
List and analyze tasks from your mind maps
Compare information across multiple mind maps
Scan directories for XMind files

Security Considerations

The XMind Mind Map Analyzer only allows access to directories that you explicitly specify during installation. It includes path normalization and validation to prevent unauthorized access to files outside the specified directories.

Examples

Here are some examples of how you can use the XMind Mind Map Analyzer with your AI assistant:

"Search for all nodes related to 'project planning' in my mind maps"
"Extract the 'Feature > API' section from my product roadmap mind map"
"List all TODO tasks from my project mind map"
"Find all mind maps in my Documents folder that contain information about marketing"
"Compare the 'Goals' sections across all my quarterly planning mind maps"

Troubleshooting

If you encounter issues with the XMind Mind Map Analyzer:

Ensure you've specified the correct path to your XMind files
Check that your XMind files are valid and not corrupted
Verify that you have the necessary permissions to access the specified directories
For development issues, use the MCP Inspector: npx @modelcontextprotocol/inspector node dist/index.js /path/to/xmind/files