Connect Xmind to your AI assistant with MCP

Connect Xmind to an AI assistant such as Claude or Codex with Xmind MCP Server, then create, find, read, and edit mind maps by asking for them in a conversation.

You can connect Xmind to an AI assistant to create, read, and edit mind maps through conversation. Turn meeting notes into a map of decisions and action items, organize research into a comparison, or ask your assistant to continue working from a map you already have.

💡 Tip: If you use ChatGPT, you can also connect through the Xmind Plugin. See Xmind ChatGPT Plugin.

To connect, you need an Xmind account and an AI app that supports remote MCP servers with Streamable HTTP and browser-based authorization. Your AI app’s plan or organization settings may affect which connections you can add.

What is Xmind MCP?

Xmind MCP Server lets AI apps connect to Xmind, so your AI assistant can create, read, and edit Xmind mind maps for you.

After connecting Xmind MCP Server to an MCP-compatible client such as Claude, Claude Code, Codex, or ChatGPT, you can use natural language to turn conversations, notes, research, and project ideas into structured, editable Xmind mind maps. You can also ask your assistant to read existing maps, summarize their structure, or help refine them through chat.

Use Xmind MCP when you want to bring visual thinking into the AI apps where your ideas, discussions, and planning already happen.

Why connect Xmind to your AI apps?

What can you do with Xmind MCP Server?

Connect your AI assistant to Xmind

You can start from an existing map in Xmind or add Xmind MCP Server in your AI app. Choose the method that matches where you want to begin.

Connect in Claude

  1. Open Claude and go to Customize > Connectors.

  2. Click Add > Add custom connector.

  3. Enter Xmind as the name and paste the following server URL.

https://app.xmind.com/api/mcp

Claude’s custom connector setup showing Xmind as the name and the Xmind MCP server URL.

  1. Continue through the authentication settings and choose Sign in now.

Claude’s Xmind connector authentication settings with Sign in now and Register automatically selected.

  1. Choose Connect, then follow the browser prompts to sign in to Xmind and authorize access. When prompted to choose a location, select the one shown in Xmind’s AI Agent tab, such as My Works or the team containing the map.

Xmind’s authorization page for Claude, with My Works selected and the Agree & Allow Access button.

  1. Return to Claude and enable Xmind for your conversation.

For setup details and availability, see Claude’s connector guide.

Connect in Claude Code

Run this command in your terminal:

claude mcp add --transport http xmind https://app.xmind.com/api/mcp

Then authorize the connection:

  1. Start Claude Code in the project where you added the server.

  2. Enter /mcp, then select xmind to authenticate.

  3. Sign in to Xmind in the browser window that opens and complete the authorization.

  4. Return to Claude Code and use /mcp to check the connection.

Claude Code’s MCP server list showing that xmind needs authentication.

For other configuration options, see Claude Code’s MCP guide.

Connect in Codex

  1. Open Codex and go to Settings > Plugins.

  2. Search for Xmind.

  3. Click Install plugin.

The Xmind plugin page in Codex with the Install plugin button.

  1. Sign in to Xmind and complete the authorization in the browser.

Xmind’s authorization page showing ChatGPT requesting access, with My Works selected.

  1. Return to Codex and start using Xmind in your chats.

Settings labels may differ between versions. See Codex’s MCP documentation for the instructions that apply to your client.

Connect in another AI app

  1. Open the app’s MCP or connector settings and add a server.

  2. Enter Xmind as its name and https://app.xmind.com/api/mcp as the server URL.

  3. Choose Streamable HTTP if the app asks for a transport type.

  4. Save the connection and follow the sign-in prompts to authorize your Xmind account.

  5. Return to the app and enable Xmind.

The app must support browser-based OAuth authorization as well as remote MCP connections.

Continue from a map open in Xmind

If you already have a map open, you can copy a prompt from Xmind that identifies the file and includes the connection information. This option is available for maps you own in Xmind on the web.

  1. Open the mind map you want to work with.

  2. Click Share, then select AI Agent.

  3. Click Copy Prompt. The button changes to Prompt Copied when the prompt has been copied.

  4. Open a conversation in your AI assistant and paste the prompt.

  5. Describe what you want the assistant to do after Then:. Keep the connection and map information already included in the prompt.

Xmind’s Share dialog with the AI Agent tab selected, showing the generated prompt, the map’s location, and the Copy Prompt button.

  1. Send the message to your AI assistant. If Xmind is not connected, follow your assistant’s instructions to add the MCP server and sign in. If the app requires manual configuration, follow the instructions for your AI app above. Approve the requested action if your app asks.

Claude reviewing the “Beating the odds in market entry” map and suggesting improvements without changing it.

  1. After your assistant reads the map, changes made through Xmind MCP are saved to the same map. Return to Xmind to review the updated topics and continue editing.

💡 Tip: If your assistant cannot access the map, check which Xmind location the connection is authorized to use. To access a map in another team, authorize the connection for that team.

Customize what your assistant can do

Your AI app may let you control whether individual Xmind actions run automatically or require approval.

In Claude, open Customize > Connectors, select Xmind, and review Tool permissions. Available choices include:

For example, you can allow reading while requiring approval for edits. Organization settings may limit these choices. See Claude’s connector guide.

Xmind actions fall into two broad groups:

Claude’s Xmind tool permissions, with interactive tools set to Always allow and read-only tools set to Needs approval.

Create a mind map from a conversation

You can create a map from content already discussed with your assistant or provide new notes and instructions. Describe what the map is for, the information it should include, and any structure or visual treatment that matters.

  1. Open a conversation in the AI app where Xmind is connected.

  2. Provide your source material or refer to content already in the conversation.

  3. Ask the assistant to create an Xmind mind map. Approve the requested action if your app asks.

    For example:

Create an Xmind mind map for a new product launch project. Organize it into decisions, action items, and open questions. Add checkboxes to necessary action items.

Claude displaying a New Product Launch map with Decisions, Action items, and Open questions branches and an Edit in Xmind button.

  1. Click “Edit in Xmind” to save the map to your Xmind workspace and open it for review and editing.

The New Product Launch map open in Xmind, with decisions, open questions, and action items with checkboxes.

The generated map can include boundaries, summaries, bold text, labels, to-dos, and relationships between branches. Supporting details and sources can be kept in topic notes.

Xmind can use mind map, timeline, table, matrix, and other structures to present the content. You can request a particular structure or color, or let the assistant choose a suitable combination.

Your assistant can also organize content for tasks such as trip planning, SWOT analysis, comparing options, documenting a process, or explaining a sequence of events. Describe the task rather than choosing every layout setting yourself.

For example:

Turn our comparison of these three project management tools into an Xmind map. Compare pricing, collaboration, reporting, and limitations in a matrix. Keep the source links with the relevant topics.

Find an existing mind map

You can find a map from your recent files, look for a name within a folder, or provide its Xmind link directly.

To continue recent work, ask:

List my recent Xmind mind maps.

If you remember the name, include it in your request:

Find the Xmind map named “Product Launch” in my recent files.

You can also specify where to look:

Look in the “Marketing” folder for maps with “Launch” in their names.

You can switch between grid and list views. Click a preview to open the map in Xmind.

Switching recent Xmind mind maps between list and grid views in Claude.

A recent-file list does not include every map you can access. Folder searches apply to the specified folder; ask the assistant to check a subfolder if the map is stored there.

Read a map and use it in your next task

Your assistant can read a map’s structure and use its contents to summarize information, identify gaps, draft content, or plan next steps.

  1. Provide the map’s Xmind link or identify it from the search results.

  2. If the file has several sheets, specify the sheet you want. You can ask the assistant to list the sheets first.

  3. Describe what you want to learn or produce.

Read The Gut Microbiome and Sleep and give me an outline.

To inspect the structure as text, ask for a Markdown outline. You can also ask the assistant to examine notes, labels, or task details attached to particular topics.

For follow-up work, explain how the map should be used:

Use the agreed decisions in this map to draft a launch brief. Put any new suggestions in a separate section for review.

If you edit the map in Xmind, ask your assistant to read it again before continuing so it works from the updated content.

Claude displaying an outline of “The Gut Microbiome and Sleep,” including Abstract, Introduction, and Review Methodology.

You can ask your assistant to list resources referenced by a map and identify the topics that contain them.

List the attachments, images, and web links in this map, grouped by the topics they belong to.

This lists the resources associated with the map. Reading the contents of an attachment or linked page depends on your assistant’s access and supported tools.

Claude listing two SVG images by topic and reporting that the map has no attachments or web links.

Edit a mind map through conversation

Identify the map, sheet, and topics you want to change, then describe the result. You do not need to name individual MCP tools.

  1. Ask your assistant to read the map or sheet you want to edit.

  2. Describe the changes and any content you want to preserve.

  3. Approve the action if prompted.

  4. Open the map in Xmind to review the result.

For example:

In the “New Product Launch” map, add a “Customer feedback” branch with topics for interviews, survey results, and follow-up actions. Keep the existing branches.

Claude showing the New Product Launch search result and a map preview with the new Customer feedback branch.

You can make several related changes in one request. For example, ask the assistant to revise topic text, move topics between branches, add notes or labels, group topics with a boundary, or connect related topics.

Group the three research topics with a boundary titled “Research.” Add a relationship from “Customer interviews” to “Positioning” labeled “Informs.”

You can also update to-do status, add images from accessible image URLs, remove topics, or remove boundaries, relationships, and summaries.

💡 Attention: Removing a topic also removes its subtopics. Identify the branch you want to remove before requesting the change.

Adjust the structure and appearance

Describe whether a change should apply to the whole sheet or only to particular topics.

Change the “Milestones” branch to a timeline. Keep the other branches in their current structures.

Apply a muted green color theme to the sheet, then make the three main decisions bold.

Color themes apply to the whole sheet. To emphasize a specific topic or branch, ask for changes to its text or fill color.

Claude displaying the New Product Launch map with a muted green theme and bold decision topics.

Update tasks

Use checkboxes for simple action lists:

Add to-do checkboxes to the action items and mark “Review the draft” as complete.

For scheduled work, you can ask the assistant to set start dates, due dates, duration, progress, or priority. Scheduled task editing requires a plan that includes the relevant task features.

Set “Prepare the launch brief” to start on October 19, 2026, and finish on October 21, 2026. Set its progress to 50%.

When checking an edit, open the map from the latest response. An earlier preview in the conversation may still show the previous state.

Claude displaying the Action items branch with to-do checkboxes and category progress indicators.

Add a new sheet to an existing file

A sheet gives you another map within the same Xmind file. Use one to keep a related plan, comparison, or follow-up alongside your original work.

  1. Identify the Xmind file you want to extend.

  2. Ask the assistant to add a new sheet and describe its content.

  3. Open the file in Xmind and select the new sheet to review it.

Add a new sheet called “Launch Checklist” to this file. Use our discussion to organize the remaining work into preparation, launch day, and follow-up. Add checkboxes to the action items and keep the existing sheets unchanged.

The new sheet can include its own content, structure, styling, notes, and annotations when it is created.

Claude displaying the new Launch Checklist sheet with Preparation, Launch day, and Follow-up branches containing to-do checkboxes.

Organize files and folders

You can ask your assistant to browse accessible spaces and folders, create folders, move maps, and rename files or folders within the authorized Xmind location.

For example:

Create a folder called “Launch Planning” in my default space, then move the “New Product Launch” and “Launch Research” maps into it.

Rename the “New Product Launch” file to “New Product Launch — Final Plan.”

Specify both the files and destination when moving content. Moving files between different authorized teams is not supported by the same connection.

To remove a file from your active files, ask the assistant to move it to the trash. You can also request that it restore a file from the trash; restoration remains subject to your plan’s file limit.

Move this outdated draft to the trash.

In a team location, you can ask the assistant to list team members. This lets you check who belongs to the connected team; it does not invite people or change their roles.

Restore an earlier version

Changes made through Xmind MCP are included in the file’s version history. To return to an earlier version, open the file in Xmind on the web.

  1. Open the mind map you want to restore.

  2. Open the main menu and choose File > Version History.

  3. Select the version you want to recover, then click Restore.

Available history depends on your plan. See How to recover version history for online files?.

After restoring a version, ask your assistant to read the map again before making further changes.

Xmind ChatGPT Plugin

Xmind Skill & CLI