Design · stdio · opencode
Excalidraw
Hand-drawn diagrams on a live canvas.
Available
stdio
2.1.2
26 tools
What it does
Creates and edits Excalidraw scenes with 26 tools for rectangles, arrows, text, grouping and export.
Produce or inspect diagrams and design files.
Tools
| Tool | Description |
|---|---|
| create_element | Create a new Excalidraw element. For arrows, use startElementId/endElementId to bind to shapes (auto-routes to edges). |
| update_element | Update an existing Excalidraw element |
| delete_element | Delete an Excalidraw element |
| query_elements | Query Excalidraw elements with optional filters |
| get_resource | Get an Excalidraw resource |
| group_elements | Group multiple elements together |
| ungroup_elements | Ungroup a group of elements |
| align_elements | Align elements to a specific position |
| distribute_elements | Distribute elements evenly |
| lock_elements | Lock elements to prevent modification |
| unlock_elements | Unlock elements to allow modification |
| create_from_mermaid | Convert a Mermaid diagram to Excalidraw elements and render them on the canvas |
| batch_create_elements | 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 re |
| get_element | Get a single Excalidraw element by ID |
| clear_canvas | Clear all elements from the canvas |
| export_scene | Export the current canvas to .excalidraw JSON format. Optionally write to a file; a path ending in .md is written in the Obsidian Excalidraw plugin format (.excalidraw.md). |
| import_scene | Import elements from a .excalidraw JSON file, an Obsidian .excalidraw.md file, or raw JSON data |
| export_to_image | Export the current canvas to a PNG or SVG image. Renders headless in the canvas server (no browser tab needed); SVGs embed the fonts they use. |
| duplicate_elements | Duplicate elements with a configurable offset |
| snapshot_scene | Save a named snapshot of the current canvas state for later restoration |
| restore_snapshot | Restore the canvas from a previously saved named snapshot |
| describe_scene | 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 change |
| get_canvas_screenshot | Render the current canvas to a PNG and return it as an image. Renders headless in the canvas server (no browser tab needed). Use this to visually verify what the diagram looks like. |
| read_diagram_guide | 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 |
| export_to_excalidraw_url | 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. |
| set_viewport | Control the canvas viewport (camera). Auto-fit all elements, zoom-to-fit a subset of elements, center on a specific element, or set zoom/scroll directly. Requires the canvas frontend open in a browser |
Install / connect
npx mcp-excalidraw-server
Client-side configuration. Secrets and connection strings belong in your own environment, never in this registry.
Safety
Local canvas process; nothing is published without an export step.