
draw.io MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, ChatGPT and Cursor draw editable draw.io diagrams from a prompt, from flowcharts to cloud architecture.
This is the official draw.io server from the maker of draw.io. The hosted version at mcp.draw.io needs no install, and shows diagrams inline in apps such as Claude.ai, ChatGPT, VS Code and Cursor. A separate npm package opens diagrams in the draw.io editor and can read and edit local .drawio files.
With the hosted server, your diagram is sent to the draw.io server. The npm package keeps the diagram in the URL fragment, which browsers do not send to a server.
Good for
- Anyone who wants a diagram from a description without drawing it by hand
- Developers who draw architecture, sequence and ER diagrams while they code
- Teams that need diagrams they can still edit in draw.io
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install draw.io MCP
Claude Code
- 1
Copy this prompt.
Add the draw.io MCP server to Claude Code. Run this command: claude mcp add --transport http draw-io https://mcp.draw.io/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Built from the package data we hold. Not yet tested by us.
Tools
Draws a diagram inline in the chat (hosted server)
Renders draw.io XML or Mermaid (28 diagram types) as an interactive diagram in the conversation. In apps that cannot show it inline, it returns a link that opens the diagram in the draw.io editor.
Try: “Draw a flowchart for a customer refund process.”
Network ·
create_diagramOpens a Mermaid diagram in the draw.io editor (npm server)
Converts Mermaid text into an editable draw.io diagram and opens it in the editor. The tool text recommends it for flowcharts, sequence, class, state and ER diagrams, Gantt charts and mind maps.
Try: “Open a sequence diagram of our login flow in draw.io.”
Network ·
open_drawio_mermaidOpens a diagram from draw.io XML in the editor (npm server)
Opens the editor with a diagram from native draw.io XML. Use it for custom styling, precise positions and stencil-based diagrams such as cloud, network and floor plans.
Try: “Draw our AWS architecture with real AWS icons and open it in draw.io.”
Network ·
open_drawio_xmlBuilds a diagram from CSV data (npm server)
Opens the editor with a diagram generated from CSV, such as an org chart built from a table.
Try: “Turn this CSV of employees and managers into an org chart.”
Network ·
open_drawio_csvFinds draw.io shapes and icons by keyword
Searches about 10,000 built-in shapes (AWS, Azure, GCP, Cisco, Kubernetes, UML, BPMN and more) and returns their style strings. The hosted server also asks the draw.io icon service for brand logos unless that is turned off.
Try: “Find the AWS Lambda and API Gateway shapes.”
Network ·
search_shapesGives the model draw.io's drawing rules
Returns the XML or Mermaid generation reference, which the model reads once per format before its first diagram.
Try: “Load the draw.io reference before drawing.”
Read ·
get_drawio_referenceLists the pages in a local .drawio file (npm server)
Lists each page's index, ID, name and size in a local .drawio file without loading the content.
Try: “List the pages in architecture.drawio.”
Files ·
list_pagesReads one page of a local .drawio file (npm server)
Returns the raw XML of one page from a local .drawio file, decompressing it if needed.
Try: “Read page 2 of architecture.drawio.”
Files ·
get_pageReplaces one page of a local .drawio file (npm server)
Overwrites the content of one page in a local .drawio file and leaves the other pages untouched.
Try: “Update page 2 of architecture.drawio with the new database box.”
Write ·
set_page
Read from the source code
Permissions
medium risk · 4 things to watch
Medium risk
The hosted server receives the diagrams you create, and the npm package can overwrite pages in local .drawio files. Use the npm or Docker version for sensitive diagrams, and keep backups of files you edit.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
The hosted server sees your diagram
The README says a diagram made with mcp.draw.io is sent to the draw.io server. Self-host it or use the npm package to keep it local. github.com
It can overwrite local .drawio pages
The page-edit tool replaces the content of one page in a local file. Keep a copy of important files. github.com
Shape search sends your search words out
The README says search_shapes queries icons.diagrams.net with the search terms unless the icon service is turned off. github.com
Your model provider sees the diagram too
The README notes the diagram is produced by your model, wherever that runs. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. The npm server can overwrite pages in a local .drawio file. |
|---|---|
| Talks to | mcp.draw.io (hosted server). app.diagrams.net and viewer.diagrams.net (editor and viewer code). icons.diagrams.net (shape search terms) |
| Sign-in and keys | No account or API key for the hosted server or the npm package. |
Questions
Is the draw.io MCP server official?
Yes. The README calls it the official draw.io MCP server, and it is published by jgraph, the maker of draw.io.
What is the draw.io MCP server URL?
The hosted URL is https://mcp.draw.io/mcp. No sign-up is needed, and the README says it works in Claude.ai, ChatGPT, VS Code, Cursor and GitHub Copilot CLI.
What is the difference between the hosted server and the npm package?
The hosted one shows diagrams inline in the chat. The npm package opens them in the draw.io editor and can also read and edit local .drawio files.
Does my diagram leave my computer?
With the hosted server, yes: it is sent to the draw.io server. With the npm package, the README says the diagram stays in the URL fragment, which browsers do not send to a server.
Do I need an account or API key?
No. Neither the hosted server nor the npm package asks for one.
Can I run it myself?
Yes. The README says you can run the app server with Node.js, use the jgraph/drawio-mcp Docker image, or deploy it to Cloudflare Workers.
Which tools does each server have?
The hosted server has three: draw a diagram, search shapes and get the reference. The npm package has eight, with open tools for XML, CSV and Mermaid and three for local files.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@drawio/mcp- Registry
- npm
- Endpoint
https://mcp.draw.io/mcp- Transport
- Streamable HTTP, stdio
- Auth
- None
- Version
- 1.4.7
- License
- Apache-2.0
- Last commit
- Oct 31, 2026
- Open issues
- 0
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- drawio-mcp README · github.com
- draw.io MCP App Server README · github.com
- draw.io tool server source · github.com
- Live tools/list on the hosted server (3 tools, all read-only hints, 2026-11-02) · mcp.draw.io