🎨 Draw.io MCP Server

Let your AI assistant create beautiful draw.io diagrams — just describe what you want.

An MCP server that generates draw.io / diagrams.net XML files programmatically. Works with GitHub Copilot (agent mode), Claude Desktop, Cursor, and any MCP-compatible client.

✨ What Can It Do?

🚀 Quick Start

Prerequisites

• Python 3.11+
• uv (recommended) or pip

Install from PyPI

pip install drawio-mcp

Or with uv:

uvx drawio-mcp

Install from source

git clone https://github.com/yohasacura/drawio-mcp.git
cd drawio-mcp
uv sync
uv run drawio-mcp

🔌 Setup with Your AI Client

VS Code (GitHub Copilot)

Add to your VS Code settings or .vscode/mcp.json:

{
  "servers": {
    "drawio-mcp": {
      "command": "uvx",
      "args": ["drawio-mcp"]
    }
  }
}

Then use Copilot in Agent mode and ask it to create diagrams.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "uvx",
      "args": ["drawio-mcp"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "uvx",
      "args": ["drawio-mcp"]
    }
  }
}

💬 Example Prompts

Once connected, try these in your AI chat:

💡 Tip: Always end with "...and save it as filename.drawio" to get a file you can open in draw.io.

🛠️ Tool Reference

The server exposes 5 tools, each with an action parameter:

diagram — Lifecycle

create · save · load · import_xml · list · get_xml · add_page · add_layer

draw — Content

add_vertices · add_edges · add_group · update_cells · delete_cells · add_title · add_legend

... View full README on GitHub