excalidraw-mcp
Provides tools for creating and managing Excalidraw diagrams, including element creation/editing, file import/export, library item insertion (e.g., AWS, Google, Docker icons), and auto-layout flowchart generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@excalidraw-mcpCreate a flowchart for user login"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Excalidraw MCP Server (Excalidraw v2 Spec Compliant)
An MCP (Model Context Protocol) Server for creating and managing Excalidraw diagrams, upgraded to follow the official Excalidraw v2 specification.
Features
Core Element Tools
Tool | Description |
| Create a single Excalidraw element |
| Create multiple elements in one call |
| Update an existing element by ID |
| Delete an element by ID |
| Query elements by type or custom filters |
| Clear all elements from canvas |
File Operations
Tool | Description |
| Export canvas to |
| Import |
| Get full scene JSON |
Library Items (Official Excalidraw Icon Packs)
Tool | Description |
| Search or list items across all installed libraries ( |
| Insert icon at position with optional scale ( |
Installed Official Libraries (499+ icons):
AWS Architecture Icons (
aws-architecture-icons): 249 icons (CloudSearch, EMR, DynamoDB, S3, EC2, Lambda, VPC, RDS, Kinesis, etc.)Google Icons (
google-icons): 139 icons (Anthos, BigQuery, Compute Engine, Cloud Run, GKE, Firestore, etc.)System Design Components (
system-design-components): 24 items (Application server, Multi-instance server, Load Balancer, etc.)Shapes for UML & ER Diagrams (
uml-er-diagrams): 21 items (Entities, Relations, Connectors, Shapes)Software Logos (
software-logos): 18 icons (Docker, JSON, Git, Database logos, etc.)Architecture Diagram Components (
architecture-diagram-components): 11 components (Slack, Docker, GitHub, VPC, Subnets)Software Architecture (
software-architecture): 7 core diagram elementsRobots (
robots): 7 illustrated robot figuresBuilt-in Common Icons (
built-in): 23 lightweight native icons
Auto-Layout Flowchart
Tool | Description |
| Create flowchart with DagreJS auto-layout |
Supported layouts: Top-Bottom (TB), Left-Right (LR), Bottom-Top (BT), Right-Left (RL) Node shapes: Rectangle, Ellipse, Diamond
// Update an existing element
update_element({ id: "mybox1", strokeColor: "#099268", text: "Updated!", width: 200 })
// Query elements by filter
query_elements({ filter: { type: "rectangle" } })
// Export to file
export_file({ filePath: "docs/architecture.excalidraw" })Related MCP server: excalidraw-architect-mcp
Setup
Add to your MCP settings file (e.g., claude_desktop_config.json, .cursor/mcp.json, or ~/.omp/agent/mcp.json):
{
"mcpServers": {
"excalidraw": {
"type": "stdio",
"command": "node",
"args": ["/path/to/excalidraw-mcp/src/cli.js"]
}
}
}This server cannot be deployed
Maintenance
Related MCP Connectors
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
Create and manage Mermaid.js flowcharts and diagrams with AI agents via MCP.
AI agent draws editable hand-drawn diagrams (flowchart, ER, architecture) via MCP, not static images
Related MCP Servers
- AlicenseBqualityFmaintenanceSecurity-hardened MCP server for Excalidraw with API key auth, rate limiting, real-time WebSocket sync, and 14 diagramming tools167183MIT
- AlicenseBqualityAmaintenanceAn MCP server that generates beautiful Excalidraw architecture diagrams with perfect auto-layout, stateful editing, and architecture-aware component styling.26150MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to programmatically create and manage flowcharts, ERDs, and swimlane diagrams. It provides tools for manipulating diagram structures, performing auto-layouts, and exporting to Mermaid or Markdown formats.2MIT
- AlicenseAqualityAmaintenanceMCP server for creating and editing diagrams using draw.io. Allows generating diagrams from Mermaid or XML, searching shapes, and opening them in draw.io for export.20Apache 2.0