Draw.io MCP

Create and edit draw.io diagrams from the agent.

📄 Files & office documents★ 1,482Updated 2026-10-13Auth: noneGitHub ↗

SourcesGitHublgazo/drawio-mcp-server

Test results

Last passed 2026-10-14

Claude CodePassed2026-10-13 · install, connect, tools, agent task

CursorPassed2026-10-13 · install, connect, tools, agent task

Claude DesktopPassed2026-10-14 · install, connect, tools, agent task

ChatGPT (Codex)Passed2026-10-14 · install, connect, tools, agent task

Protocol: 30 tools + tool call OK · 2026-10-13

🧪 Test-box note: Requires Node 22+ (harness uses ~/opt/node22). Tools act on a live draw.io editor: the server's built-in editor (--editor) is kept open in headless Chrome by scripts/drawio_sidecar.sh during tests. Published snippet: npx -y drawio-mcp-server --editor, then open http://localhost:3000/.

Install

claude mcp add drawio -- npx -y drawio-mcp-server --editor --http-port 3311

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

{
  "mcpServers": {
    "drawio": {
      "command": "npx",
      "args": [
        "-y",
        "drawio-mcp-server",
        "--editor",
        "--http-port",
        "3311"
      ]
    }
  }
}

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

{
  "mcpServers": {
    "drawio": {
      "command": "npx",
      "args": [
        "-y",
        "drawio-mcp-server",
        "--editor",
        "--http-port",
        "3311"
      ]
    }
  }
}

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.drawio]
command = "npx"
args = ["-y", "drawio-mcp-server", "--editor", "--http-port", "3311"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-13	Protocol (direct stdio)	Protocol: 30 tools + tool call OK	1.0.0
2026-10-13	Claude Code	Passed install, connect, tools, agent task	2.1.296 (Claude Code)
2026-10-13	Cursor	Passed install, connect, tools, agent task	2026.10.12-d47ca18
2026-10-14	Claude Desktop	Passed install, connect, tools, agent task	Claude Desktop 2.37337.1 (Linu
2026-10-14	ChatGPT (Codex)	Passed install, connect, tools, agent task	codex-cli 0.162.0-alpha.17.2

Tools seen by our harness (30)

get-selected-celladd-rectangleadd-edgedelete-cell-by-idget-shape-categoriesget-shapes-in-categoryget-shape-by-nameadd-cell-of-shapeset-cell-shapeset-cell-dataedit-celledit-edgelist-paged-modellist-layersset-active-layermove-cell-to-layerset-cell-parentget-active-layercreate-layerexport-diagramimport-diagramimport-mermaidlist-documentslist-pagesget-current-pagecreate-pagecopy-pagerename-pageset-document-titlesave-document