Skip to main content

draw.io for AI assistants

Describe a diagram in Claude, ChatGPT, GitHub Copilot or Cursor, and get a diagram file you can open and edit in draw.io.

No installation • No sign-in • Editable in draw.io

Get started​

Choose your assistant and follow the setup steps.

  1. Open draw.io in the Claude connectors directory and connect it.
  2. Start a new chat and describe the diagram you want.
  3. Click Open in draw.io below the diagram to edit it in the draw.io editor.

You can also add the server as a custom connector in the Claude settings, with this URL:

https://mcp.draw.io/mcp

Choose a setup

They all create native draw.io diagrams (files with the .drawio extension). They open diagrams in different locations and may require installations.

MCP App Server

Shows diagrams right in the chat, in Claude, ChatGPT, VS Code and Cursor. It is hosted at mcp.draw.io, so there is nothing to install.

MCP App Server documentation →

MCP Tool Server

An npm package for MCP clients on your computer. It opens each diagram in the draw.io editor in your browser, and also reads CSV data and Mermaid.

@drawio/mcp on npm →

Skills and plugins

The draw.io skill for Claude Code, Codex CLI, GitHub Copilot, Cursor and Antigravity creates .drawio files in your project, and can export them to PNG, SVG or PDF.

Plugin documentation →

Docker image

Run the MCP App Server on your own machine or server with the jgraph/drawio-mcp image, so diagrams stay on your network.

jgraph/drawio-mcp on Docker Hub →

GitHub repository

The source code of every variant, and the technical documentation for each client and for self-hosting.

jgraph/drawio-mcp on GitHub →
SetupWhere the diagram appearsWhat to installWhy you would choose this setup
MCP App ServerIn the chat, click Open in draw.io to edit itNothing - it is hosted at mcp.draw.ioClaude, ChatGPT, VS Code and Cursor
MCP Tool ServerIn the draw.io editor, in a new browser tabThe npm package @drawio/mcpMCP clients on your computer, CSV data and Mermaid
Skills and pluginsSaved .drawio files, PNG, SVG or PDF exports, or a linkA plugin, and draw.io Desktop to export imagesClaude Code, Codex CLI, GitHub Copilot, Cursor and Antigravity
Docker imageIn the chat, like the hosted serverDocker, on your machine or serverTo keep diagrams on your own network

Examples

Each diagram is the unedited result of the prompt written beneath.
Copy a prompt and try it in your assistant, or open the example in draw.io.

Privacy and security

  • The hosted server requires no accounts and no sign-in. It can't access your files or anything else on your device.
  • It receives only what your assistant sends to draw a diagram. It never receives your conversation content.
  • It doesn't store your diagram data, and we don't use your data to train any AI models.
  • To keep diagrams inside your own network, run the Docker image or the MCP Tool Server instead.

Questions and troubleshooting

Troubleshoot: The diagram doesn't appear in the chat

Diagrams appear in the chat in assistants that support MCP Apps: Claude, ChatGPT, VS Code with GitHub Copilot 1.109 or later, and Cursor 2.6 or later. In other assistants, such as Claude Code or GitHub Copilot CLI, the server answers with a link that will open the diagram in draw.io.

Troubleshoot: I can't add a custom MCP server in ChatGPT

Your workspace administrator may have disabled the option to add a custom MCP server. Ask your administrator to enable it.

Troubleshoot: VS Code doesn't use the draw.io tools

Click Start above the server entry in mcp.json, trust the folder when VS Code asks, and switch Copilot Chat to Agent mode. Check that the draw.io tools are turned on under Configure Tools in the chat input.

How do I change a diagram?

Ask your assistant to make a change in the same chat, for example to use another colour theme, different icons or add a missing step. To edit the diagram yourself, click Open in draw.io. See how to get the AI assistant to make changes with examples.

Which diagram types can my assistant draw?

Flowcharts, UML, ER, architecture, cloud and network diagrams, mind maps, timelines, floor plans, circuits and many more, with more than 10,000 shapes from the draw.io libraries, including AWS, Azure, Google Cloud, Kubernetes and Cisco. The generated gallery shows one example of each type with its prompt.

Can the diagrams use SAP icons, or icons from other draw.io libraries?

Yes. The draw.io MCP servers search more than 10,000 draw.io shapes, including SAP, AWS, Azure, Google Cloud, Cisco, Kubernetes and P&ID. Name the icon set in your prompt, for example "Use SAP icons" or "Use the SAP BTP service icons", and the assistant looks up the shapes before it draws the diagram. See the SAP integration example.

Is draw.io in the ChatGPT and Codex plugin directory?

Not yet. The draw.io plugin is in review for OpenAI's plugin directory. Until it is listed, add draw.io in ChatGPT as a custom MCP server, and install the draw.io plugin in Codex from GitHub.

Can I use draw.io in VS Code without the hosted server?

Yes. Run the MCP Tool Server on your computer. It needs Node.js, and will open diagrams in the draw.io editor in your browser. Add it to .vscode/mcp.json:

.vscode/mcp.json
{
"servers": {
"drawio": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}

To keep the diagrams in Copilot Chat, run the MCP App Server with Docker on your computer, and use http://localhost:3001/mcp as the URL.

Can I edit the diagrams in VS Code?

Yes, with Henning Dieterichs' unofficial draw.io extension for VS Code. It opens .drawio and .drawio.svg files in the draw.io editor inside VS Code.

Do I need to install draw.io Desktop?

Install draw.io Desktop to use draw.io editor plugins, to export diagrams to PNG, SVG or PDF and to lay them out automatically. You don't need it for .drawio files, generating links with embedded diagram information or to use the MCP servers.

Which AI model draws the diagram?

The model of your assistant writes the diagram as text. The draw.io server turns this into a draw.io diagram using native shapes. Compare AI models.

Versions and changes

The hosted server is regularly updated. Check the current version before you update packages.

Learn more

Write better prompts, change and style your diagrams, and browse examples of many different types of generated technical diagrams.