Excalidraw MCP Server

Create a new Excalidraw element. For arrows, use startElementId/endElementId to bind to shapes (auto-routes to edges).

Update an existing Excalidraw element

Delete an Excalidraw element

Query Excalidraw elements with optional filters

Get an Excalidraw resource

Group multiple elements together

Ungroup a group of elements

Align elements to a specific position

Distribute elements evenly

Lock elements to prevent modification

Unlock elements to allow modification

Convert a Mermaid diagram to Excalidraw elements and render them on the canvas

Create multiple Excalidraw elements at once. For arrows, use startElementId/endElementId to bind arrows to shapes — Excalidraw auto-routes to element edges. Assign custom id to shapes so arrows can reference them.

Get a single Excalidraw element by ID

Clear all elements from the canvas

Export the current canvas to .excalidraw JSON format. Optionally write to a file.

Import elements from a .excalidraw JSON file or raw JSON data

Export the current canvas to PNG or SVG image. Requires the canvas frontend to be open in a browser.

Duplicate elements with a configurable offset

Save a named snapshot of the current canvas state for later restoration

Restore the canvas from a previously saved named snapshot

Get an AI-readable description of the current canvas: element types, positions, connections, labels, spatial layout, and bounding box. Use this to understand what is on the canvas before making changes.

Take a screenshot of the current canvas and return it as an image. Requires the canvas frontend to be open in a browser. Use this to visually verify what the diagram looks like.

Returns a comprehensive design guide for creating beautiful Excalidraw diagrams: color palette, sizing rules, layout patterns, arrow binding best practices, diagram templates, and anti-patterns. Call this before creating diagrams to produce professional results.

Export the current canvas to a shareable excalidraw.com URL. The diagram is encrypted and uploaded; anyone with the URL can view it. Returns the shareable link.

Control the canvas viewport (camera). Auto-fit all elements, center on a specific element, or set zoom/scroll directly. Requires the canvas frontend open in a browser.