excalidraw-mcp
Provides tools to build, edit, organize, and export Excalidraw scenes (diagrams, flowcharts, whiteboards) programmatically, with support for all element types, layouts, and export to .excalidraw, SVG, PNG.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
excalidraw-mcp
An MCP (Model Context Protocol) server for Excalidraw. It lets an AI agent build, edit, organize, and export Excalidraw scenes — architecture diagrams, flowcharts, codebase maps, whiteboards — entirely headless, producing .excalidraw files you can open at excalidraw.com, plus SVG/PNG renders in Excalidraw's hand-drawn style.
Features
Every element type: rectangles, ellipses, diamonds, text, lines, arrows, freedraw strokes, frames, embedded images, and embeddables (iframes)
Real Excalidraw semantics: bound labels (text inside shapes / on arrows), arrow ↔ shape bindings that survive dragging in the UI, groups, frames, z-order, lock state, fractional indices
One-shot diagrams:
create_flowchartlays out labeled nodes and bound edges automatically (layered layout,downorright)Full editing surface: update, move, resize, duplicate (with binding remap), align, distribute, group, reorder, query
Overlap-free by default: creation tools nudge new elements to free space (
avoidOverlap: falseto layer intentionally),resolve_overlapsspreads out colliding elements, and bound arrows re-route automatically after movesPersistence & export:
.excalidrawfiles (v2),.excalidrawliblibraries, SVG and PNG rendering (roughjs + perfect-freehand, so it looks like Excalidraw)All three MCP primitives: 42 tools, resources (
excalidraw://scenes,excalidraw://scene/{id},excalidraw://scene/{id}/svg), and prompts (architecture-diagram,flowchart,annotate-scene)
Related MCP server: Excalidraw MCP Server
Setup
npm install
npm run buildClaude Code
claude mcp add excalidraw -- node /path/to/excalidraw-mcp/dist/index.js(This repo also ships a project-scoped .mcp.json, so opening the repo in Claude Code registers the server automatically.)
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"excalidraw": {
"command": "node",
"args": ["/path/to/excalidraw-mcp/dist/index.js"]
}
}
}Tools
Group | Tools |
Scenes |
|
Create |
|
Edit |
|
Organize |
|
Export |
|
Diagrams |
|
Typical flow:
create_sceneadd_shape/add_text/create_flowchart, thenconnect_elementsto wire things updescribe_sceneto verifysave_scene→ open the.excalidrawfile at excalidraw.com, and/orexport_svg/export_pngfor a preview
Example — the whole auth flowchart above is one call:
{
"name": "create_flowchart",
"arguments": {
"nodes": [
{ "id": "start", "label": "Request", "shape": "ellipse", "backgroundColor": "#b2f2bb" },
{ "id": "auth", "label": "Authenticated?", "shape": "diamond", "backgroundColor": "#ffec99" },
{ "id": "handler", "label": "Route handler" },
{ "id": "reject", "label": "401 Unauthorized", "backgroundColor": "#ffc9c9" },
{ "id": "db", "label": "Database" }
],
"edges": [
{ "from": "start", "to": "auth" },
{ "from": "auth", "to": "handler", "label": "yes" },
{ "from": "auth", "to": "reject", "label": "no", "strokeStyle": "dashed" },
{ "from": "handler", "to": "db", "label": "query" }
]
}
}Notes
Coordinates: y grows downward; shapes are positioned by their top-left corner.
PNG export uses the optional
@resvg/resvg-jsdependency; SVG export has no native dependencies.Text sizing is estimated headlessly (~0.6em per character); Excalidraw re-measures precisely when a file is opened.
Development
npm run build # compile TypeScript
npm test # end-to-end smoke test (spawns the server with a real MCP client)The smoke test writes example output (demo.excalidraw, flowchart.excalidraw, SVG/PNG renders, a .excalidrawlib) into examples/.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Create, edit and organize hand-drawn diagrams (flowcharts, ER, architecture) from any AI agent.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Flowcharts that people and agents edit together on one live canvas, exported as Mermaid.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables creation, management, and export of Excalidraw drawings through natural language. Supports CRUD operations on drawings and export to SVG, PNG, and JSON formats with file-based storage.8-
- AlicenseAqualityDmaintenanceEnables AI agents to programmatically generate, edit, and view Excalidraw diagrams with real-time browser synchronization. It provides a suite of tools for adding shapes, text, and arrows to diagrams through natural language interactions.11101MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to programmatically control a live Excalidraw canvas through element-level CRUD operations and real-time synchronization. It allows agents to iteratively build, inspect, and refine diagrams while providing visual feedback via screenshots and scene descriptions.5,646 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to programmatically control a live Excalidraw canvas with element-level CRUD operations and real-time synchronization. It supports iterative diagramming through scene descriptions, screenshots, and advanced layout tools for collaborative AI-human workflows.2MIT