← Back to directory
D

Draw.io MCP Server

Community
Let AI create and edit Draw.io diagrams directly.
GitHub source repository ↗
★ 1.4k Stars Category · Other Very popular
52FMRS · D
Reliability
8/20
Security and permissions
7/20
Maintenance
10/20
Documentation
13/20
Setup experience
14/20

This is a community-maintained Draw.io MCP Server that runs locally through stdio. The README provides configuration examples for several MCP clients, diagram-editing capabilities, document and page targeting, and built-in-editor and browser-extension modes. Because no complete tool manifest is provided, the tools field includes only identifiers explicitly named in the README.

Read the FMRS scoring method →

Draw.io MCP Server gives AI assistants control over Draw.io (Diagrams.net) diagrams, including inspection and modification of shapes, edges, pages, and layers through a built-in editor or browser extension.

Tools

list-documents
Lists connected Draw.io document instances for target selection.
list-pages
Lists pages in the target document.
get-current-page
Retrieves information about the current page.
create-page
Creates a new page.
copy-page
Copies a page.
rename-page
Renames a page.

Setup

Add the JSON from install_config to a supported MCP client configuration, restart the client, and open http://localhost:3000/. Node.js 22 or newer is required. Browser-extension usage additionally requires the extension and Draw.io open in a browser.

claude_desktop_config.json
{"mcpServers":{"drawio":{"command":"npx","args":["-y","drawio-mcp-server","--editor"]}}}

Fit and risk

Best for

  • Teams that want AI to generate or maintain Draw.io diagrams
  • Users of Claude Desktop, Claude Code, Zed, Codex, or OpenCode
  • Diagram workflows requiring multi-document, multi-page, and vendor-stencil support

Not for

  • Text-only workflows with no diagram-editing requirement
  • Users requiring a stable end-to-end Draw.io Desktop integration
  • Users unwilling to install Node.js or a browser extension

Required permissions

  • Access to connected Draw.io document instances and diagram contents
  • Permission to create, modify, and delete elements in target diagrams
  • In browser-extension mode, a connection to the Draw.io browser page and extension

Risks and side effects

  • AI actions can modify or delete diagram elements, so mistakes may damage diagram content
  • Browser-extension mode depends on connectivity between the extension and the Draw.io page
  • Self-signed TLS certificates may require browser trust and connection configuration
  • Draw.io Desktop integration is experimental and limited by an upstream CSP issue

Troubleshooting

  1. Verify that Node.js 22 or newer is installed
  2. Restart the MCP client and confirm that the configuration loads
  3. For the built-in editor, check whether http://localhost:3000/ is reachable
  4. For browser-extension mode, confirm the extension is installed, Draw.io is open, and the connection indicator is green
  5. For Firefox, ensure TLS mode is enabled
  6. For Draw.io Desktop connection failures, check the documented upstream CSP limitation

Use cases

Automatically create architecture diagrams, flowcharts, and visual documentation
Inspect, modify, and organize multi-page Draw.io diagrams
Import, embed, or expand Mermaid diagrams
Manage layers, pages, and nested shapes

Supported clients

Claude DesktopFull support
Claude CodeFull support
ZedFull support
CodexFull support
OpenCodeFull support