Skip to main content

draw.io for AI assistants

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

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

Get started​

Pick your assistant. Most need only the address of the hosted server.

  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

Every variant creates native draw.io diagrams. They differ in where the diagram appears and what you install.

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 and Cursor 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 its technical documentation for each client and for self-hosting.

jgraph/drawio-mcp on GitHub →
SetupWhere the diagram appearsWhat you installChoose it for
MCP App ServerIn the chat, with 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 pluginsAs .drawio files, PNG, SVG or PDF exports, or a linkA plugin, and draw.io Desktop for image exportsClaude Code, Codex CLI, GitHub Copilot and Cursor
Docker imageIn the chat, like the hosted serverDocker, on your machine or serverKeeping diagrams on your own network

Examples

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

Privacy and security

  • The hosted server has 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.
  • It doesn't store your diagrams, and we don't use your data to train AI models.
  • To keep diagrams on your own network, run the Docker image or the MCP Tool Server instead.

Questions and troubleshooting

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 opens the diagram in draw.io.

How do I change a diagram?

Ask your assistant for the change in the same chat, for example another colour theme, icons or a missing step. To edit the diagram yourself, click Open in draw.io. See change and style diagrams for 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 gallery shows one example of each type with its prompt.

I can't add a custom MCP server in ChatGPT

Your workspace admin may have turned off the option to add a custom MCP server. Ask your admin to turn it on.

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.

Do I need draw.io Desktop?

Only for the plugins, to export diagrams to PNG, SVG or PDF and to lay them out automatically. You don't need it for .drawio files, links or the MCP servers.

Which AI model draws the diagram?

The model of your assistant writes the diagram. The draw.io server turns it into a draw.io diagram. Write prompts compares the models, the time and the cost.

Versions and changes

The hosted server is updated for you. For the packages, check the current version before you update.

Learn more

Write better prompts, change and style your diagrams, and see an example of every diagram type.