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?
-
Work where the conversation happens — Use Xmind from Claude, ChatGPT, Codex, and other AI apps without switching tools or copying content back and forth.
-
Turn ideas into visual structure — Transform scattered notes, prompts, meeting discussions, and research into clear, editable mind maps that make complex information easier to understand.
-
Use existing mind maps as context — Let your assistant read existing Xmind mind maps and use them for summaries, planning, writing, research, or follow-up work.
-
Refine maps through conversation — Add topics, revise wording, expand branches, or reorganize ideas by simply describing what you want to change.
-
Preserve ideas as editable assets — Save AI-assisted work as Xmind mind maps that you can revisit, refine, share, and continue developing.
What can you do with Xmind MCP Server?
-
Create mind maps from conversations — Turn brainstorming sessions, research notes, meeting discussions, or project ideas into structured Xmind mind maps.
-
List recent mind maps — Ask your assistant to find recently opened Xmind mind maps in your workspace and open the one you want to continue working on.
-
Read existing mind maps — Ask your assistant to read a mind map and return its content as a structured summary or Markdown outline.
-
Get insights from a map — Extract key points, summarize the structure, identify action items, or suggest next steps based on an existing mind map.
-
Edit mind maps through chat — Add new topics, update existing content, expand branches, or reorganize ideas while keeping the map’s layout and visual style intact.
-
Continue previous work — Start from a recent Xmind map and use it as the basis for planning, writing, research, or decision-making.
-
Save ideas as reusable assets — Keep outputs as editable Xmind mind maps that can be opened, polished, shared, and built on later.
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
-
Open Claude and go to Customize > Connectors.
-
Click Add > Add custom connector.
-
Enter Xmind as the name and paste the following server URL.
https://app.xmind.com/api/mcp

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

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

- 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:
-
Start Claude Code in the project where you added the server.
-
Enter
/mcp, then select xmind to authenticate. -
Sign in to Xmind in the browser window that opens and complete the authorization.
-
Return to Claude Code and use
/mcpto check the connection.

For other configuration options, see Claude Code’s MCP guide.
Connect in Codex
-
Open Codex and go to Settings > Plugins.
-
Search for Xmind.
-
Click Install plugin.

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

- 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
-
Open the app’s MCP or connector settings and add a server.
-
Enter Xmind as its name and
https://app.xmind.com/api/mcpas the server URL. -
Choose Streamable HTTP if the app asks for a transport type.
-
Save the connection and follow the sign-in prompts to authorize your Xmind account.
-
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.
-
Open the mind map you want to work with.
-
Click Share, then select AI Agent.
-
Click Copy Prompt. The button changes to Prompt Copied when the prompt has been copied.
-
Open a conversation in your AI assistant and paste the prompt.
-
Describe what you want the assistant to do after
Then:. Keep the connection and map information already included in the prompt.

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

- 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:
-
Always allow: Run the action without asking each time.
-
Needs approval: Ask before running the action.
-
Blocked: Prevent the action.
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:
-
Read information: Find maps, read topics and sheets, inspect referenced resources, and view team members.
-
Make changes: Create or edit maps, change styles or task information, and organize files and folders.

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.
-
Open a conversation in the AI app where Xmind is connected.
-
Provide your source material or refer to content already in the conversation.
-
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.

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

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.

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.
-
Provide the map’s Xmind link or identify it from the search results.
-
If the file has several sheets, specify the sheet you want. You can ask the assistant to list the sheets first.
-
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.

Check attachments, images, and links
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.

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.
-
Ask your assistant to read the map or sheet you want to edit.
-
Describe the changes and any content you want to preserve.
-
Approve the action if prompted.
-
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.

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.

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.

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.
-
Identify the Xmind file you want to extend.
-
Ask the assistant to add a new sheet and describe its content.
-
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.

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.
-
Open the mind map you want to restore.
-
Open the main menu and choose File > Version History.
-
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.















