Drawio MCP Server

Draw.io MCP - A monorepo containing the MCP server and browser plugin

Local serverstdio

What is the Drawio MCP server?

If you already use Drawio, the drawio mcp server is the piece that lets your assistant work with it directly. Draw.io MCP - A monorepo containing the MCP server and browser plugin.

What the server does

Let's do some Vibe Diagramming with the most wide-spread diagramming tool called Draw.io (Diagrams.net).

The Draw.io MCP server brings Draw.io diagramming capabilities to AI agents. It provides MCP tools that can create, read, update, and delete diagram elements - letting AI assistants build architectural diagrams, flowcharts, and visual documentation automatically.

  • Document discovery — - list connected Draw.io document instances and route later calls to a specific tab/file instance
  • Diagram inspection — - read shapes, pages, layers, and cell properties
  • Diagram modification — - add/edit/delete shapes, edges, and labels on a target page
  • Page management — - list pages, inspect the current page, create pages, copy pages, and rename pages without forcing a visible page switch on supported runtimes
  • Layer management — - create, switch, and organize layers
  • Vendor shape coverage — - AWS, GCP, Azure, Cisco19, and CiscoSafe stencils auto-discovered at runtime from drawio's sidebar, so agents can place icons like mxgraph.gcp2.cloud_run or mxgraph.cisco19.router without hand-curated catalogs

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Multi — document targeting with list-documents and target_document selectors for multi-tab workflows
  • Per — document FIFO serialization for live operations, so multiple agents can work on different files safely
  • Parent — child relationships for nested shapes and grouping
  • Built — in Draw.io editor - no browser extension required
  • pnpm — Preferred package manager (npm works fine too)
  • Optional — The Optional tool exposed by this server

Credentials and setup notes

  • Node.js (v22 or higher; tested against v22 LTS and v24 LTS) - Runtime environment for the MCP server - MCP client - Claude Desktop, Claude Code, Zed, Codex, OpenCode, or any MCP-compatible host

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Where it fits

This sits in the cloud and infrastructure group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Drawio's toolset — Multi, Per, Parent and 3 more — is a fair guide to whether it matches your workflow. It is maintained by lgazo; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Drawio's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Multidocument targeting with list-documents and target_document selectors for multi-tab workflows
Perdocument FIFO serialization for live operations, so multiple agents can work on different files safely
Parentchild relationships for nested shapes and grouping
Builtin Draw.io editor - no browser extension required
pnpmPreferred package manager (npm works fine too)
OptionalThe Optional tool exposed by this server.

How to install the Drawio MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js (v22 or higher; tested against v22 LTS and v24 LTS) - Runtime environment for the MCP server - MCP client - Claude Desktop, Claude Code, Zed, Codex, OpenCode, or any MCP-compatible host

Example prompts to try

  • Use Drawio to Multi.
  • Use Drawio to Per.
  • Use Drawio to Parent.

Frequently asked questions

It connects Drawio to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Multi, Per, Parent, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Drawio directly.