All servers / Design / Draw.io MCP server
Draw.io MCP server
Provides Draw.io services to MCP Clients
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-19 on package version 2.4.0. Package: drawio-mcp-server · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (3.2 seconds including download)
- Tools offered: 30
- Last published: 2026-10-31
- Weekly downloads (npm): 1,140
- License: MIT · Direct dependencies: 9
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
get-selected-cell2 of 2 parameters describedThis tool retrieves the selected cell on the target page of the current Draw.io document. If the target page is not currently visible, Draw.io may switch the visible page first because selection is UI-bound.
add-rectangle9 of 9 parameters describedThis tool allows you to add a new Rectangle vertex cell on the target page of the current Draw.io document.
add-edge8 of 8 parameters describedThis tool creates an edge, sometimes called also a relation, between two vertexes (cells). When source and target are the same shape (self-connector), a loop edge style is automatically applied if no custom style is provided.
delete-cell-by-id3 of 3 parameters describedDeletes a cell from the target page, whether it is a vertex or edge.
get-shape-categories1 of 1 parameter describedRetrieves available shape categories from the diagram's library. Library is split into multiple categories.
get-shapes-in-category2 of 2 parameters describedRetrieve all shapes in the provided category from the diagram's library. A shape primarily contains `style` based on which you can create new vertex cells.
get-shape-by-name2 of 2 parameters describedRetrieve a specific shape by its name from all available shapes in the diagram's library. It returns the shape and also the category it belongs.
add-cell-of-shape10 of 10 parameters describedThis tool allows you to add a new vertex cell on the target page of the current Draw.io document by its shape name.
set-cell-shape4 of 4 parameters describedUpdates the visual style of an existing vertex cell to match a library shape by name.
set-cell-data5 of 5 parameters describedSets or updates a custom attribute on an existing cell.
edit-cell9 of 9 parameters describedUpdate properties of an existing vertex/shape cell by its ID. Only provided fields are modified; unspecified properties remain unchanged.
edit-edge8 of 8 parameters describedUpdate properties of an existing edge by its ID. Only provided fields are modified; unspecified properties remain unchanged. Supports setting waypoints for edge geometry control.
list-paged-model5 of 5 parameters describedRetrieves a paginated view of all cells (vertices and edges) on the target page. This tool provides access to the complete model data with essential fields only, sanitized to remove circular dependencies and excessive data.
list-layers2 of 2 parameters describedLists all available layers on the target page with their IDs and names.
set-active-layer3 of 3 parameters describedSets the active layer for creating new elements. All subsequent element creation will happen in this layer. If the target page is not currently visible, Draw.io may switch the visible page first because active-layer state is UI-bound.
move-cell-to-layer4 of 4 parameters describedMoves a cell from its current layer to a target layer.
set-cell-parent4 of 4 parameters describedSets the parent of a cell, making it a child of the specified parent cell. This allows creating hierarchical relationships where moving the parent also moves its children.
get-active-layer2 of 2 parameters describedGets the currently active layer information for the target page. If the target page is not currently visible, Draw.io may switch the visible page first because active-layer state is UI-bound.
create-layer3 of 3 parameters describedCreates a new layer on the target page.
export-diagram14 of 14 parameters describedExport the target page or current diagram as SVG, PNG, or XML. Returns the diagram data as base64 (PNG) or text (SVG/XML). Optionally saves to a file.
import-diagram6 of 6 parameters describedImport a diagram from XML, SVG with embedded XML, or PNG with embedded XML into the current Draw.io instance. `target_page` is required for `replace` and `add`, and optional for `new-page`.
import-mermaid5 of 5 parameters describedInsert a Mermaid diagram into the target Draw.io page. Conversion runs inside the Draw.io editor via its bundled Mermaid pipeline (EditorUi.parseMermaidDiagram). mode='native' converts supported Mermaid types into native mxGraph cells; unsupported types fall back to an embedded image cell. mode='embed' always emits a single image cell that preserves the Mermaid source for re-editing inside Draw.io. `target_page` is required for `replace` and `add`, and optional for `new-page`.
list-documentsno parametersLists all connected Draw.io document instances with their stable instance IDs and basic metadata.
list-pages1 of 1 parameter describedLists all pages in the current Draw.io document with their index, id, name, and current-page flag.
get-current-page1 of 1 parameter describedGets the currently visible page metadata, including index, id, name, and whether it is active.
create-page2 of 2 parameters describedAppends a new blank page to the current Draw.io document without changing the visible page when the runtime supports background page insertion.
copy-page3 of 3 parameters describedCreates a copy of an existing page in the target/current Draw.io document, appends the copy to the end of the page list, and returns the copied page metadata. When possible, the previously visible page is restored after the copy is created.
rename-page3 of 3 parameters describedRenames the selected page without changing the visible page.
set-document-title2 of 2 parameters describedRenames the current Draw.io document through its active storage provider while preserving the existing file extension when one is present.
save-document1 of 1 parameter describedTriggers Draw.io's existing File > Save action for the current document. The active storage provider may display an authentication, conflict, or Save As prompt that requires user interaction.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.