jgraph/drawio-mcp repository overview

⁠draw.io MCP server

The official draw.io⁠ MCP server. It gives LLMs three tools: create_diagram renders draw.io XML as an interactive diagram inline in chat on MCP Apps hosts (Claude.ai, ChatGPT, VS Code, Cursor and others), with an "Open in draw.io" button, search_shapes finds shapes across the draw.io libraries (AWS, Azure, GCP, Cisco, Kubernetes, P&ID, electrical, BPMN and more), and get_drawio_reference returns the diagram syntax reference the model reads before its first diagram.

This image runs the same server that is hosted at https://mcp.draw.io/mcp. Use it when you want to self-host, for example to keep diagram data inside your own network.

⁠Usage

docker run --rm -p 127.0.0.1:3001:3001 jgraph/drawio-mcp

The MCP endpoint is then http://localhost:3001/mcp (Streamable HTTP). Add it as a remote MCP server in your host.

Hosts that need a public URL (such as Claude.ai or ChatGPT) can reach a local container through a tunnel, for example npx cloudflared tunnel --url http://localhost:3001, and use the tunnel URL with /mcp appended. Anyone who has that URL can use the server.

⁠Deployment boundary

• Network exposure. -p 127.0.0.1:3001:3001 makes the server reachable from this machine only. -p 3001:3001 publishes it on every interface of the Docker host, so everyone on your network can reach it.

• Authentication. The server has none. If teammates should reach it, put it behind a reverse proxy or gateway that authenticates them, and set ALLOWED_HOSTS to the hostname they use.

• Storage. Nothing is stored. The server is stateless, needs no volume, and does not write diagram content to its logs (only request metadata: method, status, timing). Diagrams live in the chat and in the draw.io files you save.

• Outbound access from the container. None is needed for diagrams. Diagram content is never sent anywhere. The shape library is built into the image. The only outbound requests are:

  • icons.diagrams.net for search_shapes, when the built-in library has no strong match; carries only the search terms. DRAWIO_ICON_SERVICE_URL=off disables it.
  • viewer.diagrams.net, a version check for the edge-routing code at startup and once a day. It carries no data and times out after 5 seconds, so it is harmless to block.

• Outbound access from the user's browser. The inline diagram viewer in the chat loads:

  • the draw.io viewer code from viewer.diagrams.net
  • shape images from app.diagrams.net, and icons from icons.diagrams.net, for diagrams that use them
  • web fonts from fonts.googleapis.com and fonts.gstatic.com, for diagrams that use them

  These requests fetch code, images and fonts only, never diagram content. "Open in draw.io" opens the diagram in the draw.io editor at app.diagrams.net; the diagram travels in the part of the link after #, which the browser keeps to itself and never sends to the server.

⁠Tags

• latest — the current release
• 1.0.3, … — one tag per server version

Images are built for linux/amd64 and linux/arm64.

⁠Links

• Source and documentation⁠ (Apache-2.0)
• Dockerfile⁠
• Data residency and offline use⁠
• Issues⁠