xmind

Create and read XMind mind map files in modern and legacy formats.

94|14|Updated Dec 12, 2024
One-click install
npx skills add https://github.com/apeyroux/mcp-xmind --skill xmind-apeyroux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xmind
Source: https://github.com/apeyroux/mcp-xmind/tree/main/skills/xmind
Command: npx skills add https://github.com/apeyroux/mcp-xmind --skill xmind-apeyroux

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Creating or parsing .xmind mind map files normally requires the XMind application or heavy libraries; this Skill lets you generate, read, search, and analyze mind maps directly from natural language requests using zero-dependency Node.js scripts. ## Core Features & Use Cases - Mind Map Creation: Build .xmind files with nested topics, notes, labels, markers, callouts, boundaries, relationships, attachments, and layouts such as org charts, fishbone diagrams, timelines, and free-positioning flowcharts. - Task & Gantt Planning: Add simple todo/done tasks or planned tasks with dates, duration, progress, priority, and dependencies for Gantt-style project plans. - Reading & Analysis: Parse full map structures, fuzzy-search nodes, filter tasks by status, compare multiple files, and scan directories for .xmind files. - Format Compatibility: Reads and writes both modern XMind Zen/2020+ (JSON) and legacy XMind 8 (XML) formats, preserving existing themes when updating files. - Use Case: Ask to turn a project brief into a Gantt chart mind map, then later ask which tasks are still incomplete in the generated file. ## Quick Start Ask the assistant to create a mind map of your project plan and save it as an .xmind file on your Desktop.

Frequently Asked Questions about xmind

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an XMind mind map file from the command line?

Pipe a JSON object with a path and sheets array into the create_xmind.mjs Node.js script. The script writes a valid .xmind file using only Node.js built-ins, with no npm dependencies required.

How do I read or search an existing .xmind file?

Pipe a JSON object with an action field to read_xmind.mjs. Actions include read, list, search_files, read_multiple, extract_node, search_nodes, and format_info, covering full parsing, fuzzy node search, and task filtering.

Does this support both XMind 8 and newer XMind formats?

Yes. Reading auto-detects the format by checking for content.json (modern Zen/2020+) or content.xml (legacy XMind 3-8). For writing, set the format field to legacy or xmind8 to produce the older XML format.

Can I build a Gantt chart or project plan in XMind?

Yes. Add planned task fields such as durationDays, startDate, dueDate, progress, priority, and dependencies to topics. XMind then renders them in its Gantt view, with relative scheduling via durationDays and dependencies preferred.

Will editing an existing .xmind file lose its theme and styling?

No. When the output path already exists, create_xmind.mjs matches sheets by title and carries forward the existing theme, layout extensions, and embedded resources like thumbnails. Keep sheet titles stable to preserve styling.

What are the limitations of HTML notes in XMind topics?

HTML notes only support strong, u, ul, ol, li, and br tags. The code tag is not supported by XMind, so code snippets should be kept as plain text notes instead.