drawio-mcp-server

Overview

This MCP server allows AI models to programmatically generate diagrams using Draw.io without needing a browser or Draw.io instance. It provides access to over 700 Azure architecture icons organized into categories, along with basic shapes and flowchart elements. The server supports batch operations for better performance, layer management, and style presets. It can generate standard Draw.io XML format that's compatible with both desktop and web versions of Draw.io.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search-shapes

  Fuzzy search for shapes including 700+ Azure icons.

  Try:Find Azure storage iconsTry:Search for flowchart shapesTry:Look for database symbols
• get-shape-categories

  List all shape categories (General, Flowchart, Azure categories).

  Try:Show me all shape categoriesTry:What categories are available?Try:List icon categories
• add-cells

  Add vertices and/or edges to the diagram.

  Try:Add a server icon to the diagramTry:Create a rectangle with 'Database' textTry:Add a connection between two shapes
• edit-cells

  Update vertex cell properties (position, size, text, style).

  Try:Change the position of the database iconTry:Update the text on a shapeTry:Resize a rectangle
• export-diagram

  Export the diagram as Draw.io XML.

  Try:Export the diagram as XMLTry:Get the Draw.io file contentTry:Save the current diagram
• import-diagram

  Import a Draw.io XML string, replacing the current diagram.

  Try:Load this diagram XMLTry:Import a Draw.io fileTry:Open this diagram
• list-layers

  List all layers with IDs and names.

  Try:Show me all layersTry:What layers exist?Try:List diagram layers
• create-layer

  Create a new layer.

  Try:Create a 'Background' layerTry:Add a new layer for iconsTry:Make a 'Network' layer
• create-page

  Create a new page (tab) in the diagram.

  Try:Add a new page for architectureTry:Create a 'Deployment' tabTry:Make a backup page
• list-pages

  List all pages with IDs and names.

  Try:Show me all pagesTry:What pages are in this diagram?Try:List diagram tabs
• get-diagram-stats

  Get statistics about cell counts, bounds, and layer distribution.

  Try:Show diagram statisticsTry:How many elements are in this diagram?Try:Get diagram metrics
• set-cell-shape

  Apply library shape styles to existing cells.

  Try:Change this rectangle to a server iconTry:Apply an Azure storage styleTry:Use the database symbol style

Comparable tools

Installation

deno run --allow-net --allow-read --allow-env src/index.ts

{
  "mcpServers": {
    "drawio": {
      "command": "deno",
      "args": ["run", "--allow-net", "--allow-read", "--allow-env", "/path/to/drawio-mcp-server/src/index.ts"]
    }
  }
}

docker pull simonkurtzmsft/drawio-mcp-server:latest
docker run -d --name drawio-mcp-server -p 8080:8080 simonkurtzmsft/drawio-mcp-server:latest

FAQ

Can I export to PNG/SVG/PDF format?

The server generates Draw.io XML format. For PNG/SVG/PDF conversion, use jgraph's Draw.io `skill-cli` workflow.

How do I find specific shapes?

Use the `search-shapes` tool with fuzzy search to find shapes by partial name across the entire icon library.

Compare drawio-mcp-server with