Connect draw.io MCP to Your AI Agent

Describe the steps or components and open the resulting diagram for review.

2 tools Custom credential

Try a draw.io MCP Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill draw.io MCP

Draw a process flow

Translate a supplied process into a diagram you can edit in draw.io.

/oo draw.io MCP: Create a draw.io flowchart from [process steps and decisions] using Mermaid. Label each branch clearly and provide the editor link so I can inspect and save the diagram.

Draw a system architecture

Use matching vendor shapes to illustrate the supplied components and connections.

/oo draw.io MCP: Draw [system components and connections] in draw.io XML. Search the library for shapes matching [vendors or technologies], label the connections and provide the editor link with any reported rendering issues.

Start Working with draw.io MCP

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect draw.io MCP

Select the hosted draw.io MCP server or supply a self-hosted HTTPS MCP endpoint; no credentials are required.
Connect draw.io MCP →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Self-hosted jgraph/drawio-mcp mcp-app-server must be version 1.0.4 or later to return editor links.
The selected server receives diagram content. Creating the editor link does not save a diagram on draw.io.

draw.io MCP Tools

Build diagrams from Mermaid or draw.io XML, and search the shape library for vendor or industry symbols. The result is an editor link containing the diagram source, ready to open, adjust and save yourself.

Diagram links

Build an editor link from Mermaid or draw.io XML.

Shape library search

Find vendor and industry shapes for XML diagrams.

2 tools

Create Diagram

Build a draw.io diagram from Mermaid or draw.io XML and return a link that opens it in the draw.io editor. Nothing is saved on the draw.io side; share the link with the user to view or edit the diagram.

drawio_mcp.create_diagram

Search Shapes

Search the draw.io shape library for vendor, industry, and icon shapes, such as cloud services, network devices, P&ID symbols, and product logos, and return the style strings to use in draw.io XML. Basic shapes such as rectangles, diamonds, and cylinders do not need a search.

drawio_mcp.search_shapes

Frequently Asked Questions

Should I use Mermaid or XML?

Mermaid suits flowcharts, sequences and other supported diagram types. XML offers more control for cloud architecture, network layouts and specialized shapes.

How do I save the diagram?

Open the editor link, review the rendered diagram and save or export it in draw.io. The source is encoded in the link.

Does an empty error list prove the diagram is correct?

No. Mermaid is converted when the editor link opens, and the server checks XML for selected rendering issues. Inspect the rendered result to verify the content and layout.