draw.io — Claude Code MCP server: what it does, how to install
Lets an agent build draw.io diagrams from Mermaid or XML and show them in the chat, with an Open in draw.io button for editing. Searches 10,000+ shapes.
Apache-2.0 ★ 5,876 updated 2026-10-24
claude mcp add --transport http mcp https://mcp.draw.io/mcpWhat draw.io does
The server is hosted, so there is nothing to install: add https://mcp.draw.io/mcp as a remote MCP server in your client. The agent sends it draw.io XML or Mermaid code (28 Mermaid diagram types), and the conversation gets a live viewer that you can send to the draw.io editor.
create_diagram renders the result. search_shapes looks up shapes by keyword across AWS, Azure, GCP, Kubernetes, UML, BPMN, Cisco and other libraries, and returns style strings ready to paste into XML, so the agent should call it before create_diagram. get_drawio_reference hands the model a format guide, which it reads once per format before its first diagram.
Inline rendering needs a host with MCP Apps support: Claude.ai, ChatGPT, VS Code with GitHub Copilot, Cursor. A terminal has no place to draw, so GitHub Copilot CLI gets a link that opens the diagram in draw.io. On Cursor older than 2.6 the diagram will not render in chat, and you need the stdio server @drawio/mcp instead.
What it helps with
- draw a process flowchart from a plain-text description
- turn Mermaid code into an editable draw.io diagram
- find AWS, Kubernetes or Cisco shapes with ready-made styles
- build a UML or BPMN diagram and open it in the draw.io editor
Example prompts for the agent
- Draw a refund flowchart in draw.io and show it in the chat
- Use draw.io to find AWS shapes and lay out a load balancer in front of a database
- Convert this Mermaid diagram into a draw.io diagram I can open in the editor
How to install draw.io
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.draw.io/mcpPlatform CLI: remote server
codex mcp add drawio --url https://mcp.draw.io/mcpConfig file
{
"mcpServers": {
"drawio": {
"url": "https://mcp.draw.io/mcp"
}
}
}Config file
{
"servers": {
"drawio": {
"type": "http",
"url": "https://mcp.draw.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http drawio https://mcp.draw.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about draw.io
How do I install draw.io in Claude Code?
Run claude mcp add --transport http mcp https://mcp.draw.io/mcp, then claude mcp add --transport http drawio https://mcp.draw.io/mcp. The two commands differ only in the server name.
What does the draw.io MCP server do?
It takes draw.io XML or Mermaid from the agent and shows an interactive diagram in the chat. A separate tool searches 10,000+ shapes by keyword and returns style strings for the XML.
Which hosts show the diagram right in the chat?
Hosts with MCP Apps support: Claude.ai, ChatGPT, VS Code with GitHub Copilot and Cursor. GitHub Copilot CLI still works with the server but replies with a link to the diagram in draw.io.