PlugWiki
draw.io logo

draw.io MCP Server: Setup for Claude, Cursor and Other Apps

OfficialRemoteLocal
Gethttps://mcp.draw.io/mcpjgraph/drawio-mcp

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.

Install draw.io MCP

Claude Code

  1. 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. 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_diagram

  • Opens 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_mermaid

  • Opens 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_xml

  • Builds 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_csv

  • Finds 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_shapes

  • Gives 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_reference

  • Lists 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_pages

  • Reads 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_page

  • Replaces 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-onlyNo read-only mode is documented. The npm server can overwrite pages in a local .drawio file.
Talks tomcp.draw.io (hosted server). app.diagrams.net and viewer.diagrams.net (editor and viewer code). icons.diagrams.net (shape search terms)
Sign-in and keysNo 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

WebsiteGitHubnpmOfficial MCP RegistryIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. drawio-mcp README · github.com
  2. draw.io MCP App Server README · github.com
  3. draw.io tool server source · github.com
  4. Live tools/list on the hosted server (3 tools, all read-only hints, 2026-11-02) · mcp.draw.io

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.