What it does
The official draw.io MCP server opens diagrams directly in the draw.io editor. It accepts XML, CSV, and Mermaid.js formats, making it flexible for different diagram sources. The server includes lightbox and dark mode rendering options. Crucially, diagram data stays local—encoded in URL fragments that browsers do not transmit to servers—avoiding external dependencies or data residency concerns. Compatible with Claude Desktop and any MCP-compatible client.
Who it's for
Backend and full-stack developers integrating Claude into MCP clients who need to generate and edit diagrams. Teams with data residency requirements or offline-first workflows. Anyone building Claude Desktop applications that rely on visual design collaboration.
Common use cases
- Generate system architecture or deployment diagrams from Claude's infrastructure analysis
- Create flowcharts and UML diagrams in CSV or Mermaid format, then edit in draw.io
- Produce BPMN or sequence diagrams for business process documentation
- Share editable diagram URLs with embedded XML for asynchronous team collaboration
Setup pitfalls
- Requires filesystem write access for MCP state and temporary files
- Diagram data embedded in URLs has practical size limits (roughly 2000 characters for safe browser compatibility)
- Network access to reach the draw.io editor required; does not work in fully airgapped environments
- CSV and Mermaid formats may require preprocessing to ensure valid draw.io XML output