Draw.io

An MCP server that programmatically generates draw.io diagrams for use with AI assistants and MCP clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run the Draw.io MCP Server locally to programmatically generate draw.io diagrams from natural language prompts or AI assistants. This server exposes diagram creation, editing, styling, and layout capabilities that you can drive from your MCP clients, enabling seamless diagram automation for flowcharts, UML, ER diagrams, and more.

How to use

Connect your MCP client to the Draw.io MCP Server and start issuing diagram-related actions through a simple, API-like interface. You can ask your AI assistant to create, modify, import, or export diagrams, then save the final result as a .drawio file. Typical workflows include creating a diagram from a prompt, applying styles and themes, arranging layout, and exporting the finished diagram.

How to install

Prerequisites you need before installing any server component:

Python 3.11+ is required to install and run the server using Python-based tooling.
Use uvx for a streamlined local run or install with pip if you prefer a Python-based approach.

Install from PyPI using pip or uvx to run the server locally:

pip install drawio-mcp

uvx drawio-mcp

Additional setup notes

If you prefer running from source, clone the repository, sync dependencies with UV tooling, and start the server locally. The following steps illustrate a typical local development flow.

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

# Run the server locally
uv run drawio-mcp

Available tools

diagram

Lifecycle and operations to create, load, save, and manipulate draw.io diagrams.

draw

Modify diagram content by adding vertices, edges, groups, and labels.

style

Apply themes, presets, and styles to shapes and connections.

layout

Position elements using Sugiyama, tree, grid, flowchart, or smart connect algorithms.

inspect

Read-only querying of diagram metadata, cells, overlaps, and ports.