Drawio MCP Server

MCP server that brings Draw.io diagramming capabilities to AI agents. Enables programmatic creation, inspection, and modification of diagrams including architectural diagrams, flowcharts, and visual documentation.

Features

• Built-in editor - Server hosts Draw.io directly, accessible in your browser at http://localhost:3000/
• Document discovery - List connected Draw.io document instances and route calls to specific tab/file instances
• Diagram inspection - Read shapes, pages, layers, and cell properties
• Diagram modification - Add/edit/delete shapes, edges, and labels on target pages
• Page management - List, inspect, create, copy, and rename pages
• Layer management - Create, switch, and organize layers
• Multi-document targeting - Work with multiple tabs/files simultaneously
• Multi-page targeting - Page-scoped tools with target_page selectors
• Vendor shape coverage - AWS, GCP, Azure, Cisco19, and CiscoSafe stencils auto-discovered at runtime
• Mermaid support - Import, embed, or expand Mermaid diagrams
• Import/Export - Diagrams from/to XML, SVG (with embedded XML), or PNG (with embedded XML)
• Edge geometry control - Waypoints and automatic self-connector routing
• Parent-child relationships - Nested shapes and grouping
• Built-in TLS - Optional HTTPS + WSS with manual cert/key or auto-generated self-signed certificates

Usage

After configuration, open the built-in editor at http://localhost:3000/ and interact with your AI assistant:

• "Create an event-driven architecture diagram showing a message queue with producers, consumers, and three backend services"
• "Draw a CRUD API diagram with a database, API gateway, and four microservices with their endpoints"
• "Add a new layer called 'Background' and move all decorative elements to it"

Browser Extension Alternative

Instead of the built-in editor (--editor flag), you can use the browser extension to connect to Draw.io running in your browser. Available for Chrome and Firefox.