Draw.io Diagrams Remote MCP Server
Draw.io's hosted MCP (mcp.draw.io/mcp) is a rare public, unauthenticated endpoint: send a description, get back a renderable drawio diagram and open it in the editor โ with ui:// MCP Apps support for in-canvas previews.
ไธญๆ็ฎไป
drawio๏ผdiagrams.net๏ผๅฎๆน่ฟ็จ MCP ๆๅกๅจ๏ผๅ ฌๅผๅ ็ปๅฝใAI ไปฃ็ๅฏ็ๆ drawio XML ๅพ่กจๅนถ้่ฟ MCP Apps ไบคไบ็้ข็ดๆฅๅจ็ผ่พๅจไธญๆๅผใ
Maintainer of Draw.io Diagrams? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"drawio": {
"url": "https://mcp.draw.io/mcp"
}
}
}claude mcp add --transport http drawio https://mcp.draw.io/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"drawio": {
"type": "http",
"url": "https://mcp.draw.io/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.draw.io/mcp - No authentication needed โ tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.draw.io/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"drawio": {
"serverUrl": "https://mcp.draw.io/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"drawio": {
"url": "https://mcp.draw.io/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.drawio] url = "https://mcp.draw.io/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"drawio": {
"type": "streamableHttp",
"url": "https://mcp.draw.io/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"drawio": {
"httpUrl": "https://mcp.draw.io/mcp"
}
}
}๐งฐ Draw.io Diagrams MCP Tools & Schema (3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| create_diagram ~1612 tok | ๐ข Readidempotent | Creates and displays an interactive draw.io diagram from Mermaid.js syntax or draw.io XML โ provide exactly one. **Choose the format first.** Use `xml` for diagrams of boxes and lines up to about 30 shapes: flowcharts, pipelines, decision trees, org charts, ER schemas, UML class, state and use case diagrams, mind maps, timelines, architecture, cloud and network diagrams, swimlanes, UI mockups, floor plans and anything with stencils. You place every shape yourself, laid out for the chat view (see the XML reference). Use `mermaid` for sequenceDiagram, gantt, gitGraph, pie, journey, quadrantChart, xychart-beta, sankey-beta, requirementDiagram, C4Context/C4Container/C4Component, block-beta, packet-beta, kanban, radar-beta, treemap-beta, treeView-beta, venn-beta, ishikawa-beta, zenuml, wardley-beta, eventmodeling, and for flowcharts, class and state diagrams of more than about 30 shapes (flowcharts with postLayout elk). Whenever the user asks for draw.io XML or no Mermaid, use XML for the rest of the conversation. **Call `get_drawio_reference` before your first diagram in a conversation**, once per format, with the format you chose: "mermaid" has the syntax for every type (a misspelled header renders blank), "xml" the styles, layout grid, edges, containers, layers and dark mode. Call `search_shapes` first for industry icons (AWS, Azure, GCP, Cisco, Kubernetes, P&ID, electrical) or logos. XML essentials: <mxGraphModel adaptiveColors="auto"><root><mxCell id="0"/><mxCell id="1" parent="0"/>โฆ</root></mxGraphModel>. Every cell has a unique id. Vertices: vertex="1" with <mxGeometry x y width height as="geometry"/>. Edges: edge="1" with source and target, always with a child <mxGeometry relative="1" as="geometry"/>. Put html=1 in every style and XML-escape HTML in values (< > & "). No XML comments. Don't add waypoints. Place the shapes yourself (no postLayout) and set `routing: "libavoid"` only when an edge would otherwise cross a shape. | xml: stringmermaid: stringpostLayout: stringdirection: stringrouting: string |
| search_shapes ~331 tok | ๐ข Readidempotentopen-world | Search the draw.io shape library by keywords. Returns matching shapes with their exact style strings, dimensions, and titles. Covers ~10,000 built-in stencils (cloud architecture, network topology, P&ID, electrical, Cisco, Kubernetes, BPMN) and, when those are sparse, supplements results with the draw.io icon service (brand/product logos and general-purpose concept icons, e.g. 'react', 'slack', 'shopping cart', 'solar panel'). Use ONLY for diagrams that need industry-specific, branded, or pictorial icons. Do NOT use for standard diagram types like flowcharts, UML, ERD, org charts, or mind maps โ these use basic geometric shapes (rectangles, diamonds, circles, cylinders) that are already covered in the XML reference. Also skip if the user asks to use basic/simple shapes or says not to search. The style string from the results can be used directly in mxCell style attributes. | query*: stringlimit: number |
| get_drawio_reference ~226 tok | ๐ข Readidempotent | Returns the draw.io diagram generation reference as Markdown. Format "xml": styles, the layout grid, edges, containers, swimlanes, layers, tags, metadata, dark mode, the layout and routing passes, and the well-formedness rules for create_diagram's xml. Format "mermaid": the header keyword and syntax hints for every Mermaid type draw.io supports, flowchart styling and the ELK layout. Call it once per format and conversation, before the first diagram in that format; the reference stays valid for the rest of the conversation. | format*: string |
๐ก๏ธ Security, Quality & Context Token Audit
Every tool definition (name + description + input schema) is injected into your LLMโs context on every request โ Estimate per-call LLM token cost โ
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- Public read-only-friendly endpoint โ no credentials stored client-side
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- None (public)
- Dynamic Client Registration
- โ
- PKCE S256
- โ
- Protected resource metadata
- https://mcp.draw.io/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Draw.io Diagrams MCP Endpoint Overview & Security Guide
Draw.io Diagrams MCP โ Remote MCP Server
Draw.io's remote MCP is one of the best zero-config endpoints to try the ecosystem with: no API key, no OAuth, just POST an initialize and start generating flowcharts, sequence diagrams and architecture maps that open straight in the diagrams.net editor โ and its interactive MCP Apps view renders the diagram inline in supporting clients.
Official Draw.io Diagrams MCP Endpoint & Transport Architecture
- Endpoint URL:
https://mcp.draw.io/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Draw.io Diagrams MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Draw.io Diagrams MCP is public and unauthenticated โ no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.
Of the 4 cataloged tools, 2 are read-only and 2 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.
Common Troubleshooting & Connection Tips
- "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Public endpoint โ do not include sensitive architecture details in diagram prompts.
- MCP Apps ui:// rendering works in hosts that support interactive tool results.
๐ How to Connect
- Copy the Draw.io Diagrams MCP endpoint URLThe remote endpoint is https://mcp.draw.io/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http drawio https://mcp.draw.io/mcp. Cursor: add"drawio": { "url": "https://mcp.draw.io/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Verify with the online inspectorPaste https://mcp.draw.io/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Draw.io Diagrams MCP's 4 tools respond.
โ FAQ
What is the Draw.io Diagrams MCP remote MCP endpoint?
The primary endpoint is https://mcp.draw.io/mcp. It is an official first-party server operated by drawio (diagrams.net), speaking the Streamable HTTP transport.
How do I authenticate with Draw.io Diagrams MCP?
You don't โ Draw.io Diagrams MCP is public and unauthenticated. Connect and start calling tools; no OAuth flow or API key is needed.
I'm getting a 401 Unauthorized from Draw.io Diagrams MCP โ what's wrong?
Draw.io Diagrams MCP is authless, so a 401 is unusual. Check that you're hitting https://mcp.draw.io/mcp exactly (including the path) and not an API endpoint that requires a different credential.
Which MCP clients work with Draw.io Diagrams MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http drawio https://mcp.draw.io/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does Draw.io Diagrams MCP expose?
4 tools are cataloged in this directory โ including `create_diagram`, `open_in_editor`, `get_diagram_preview` and more. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.
Canva's official remote MCP server. Agents can search your designs, generate new designs from templates, autofil brand content and export to image or PDF โ with interactive MCP Apps rendering.
CastHTML's hosted remote MCP server. CastHTML's MCP lets Claude, Cursor and other AI agents publish generated HTML dashboards or Markdown research reports as sandboxed, shareable online links (cast_live_... API key as bearer). It authenticates with a bearer token or API key sent via the Authorization header.
WordPress.com's official remote MCP server hosted by Automattic. Agents can read posts and pages, manage content drafts and inspect site settings over OAuth.