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

File Operations

Library Items (Official Excalidraw Icon Packs)

Installed Official Libraries (499+ icons):

1. AWS Architecture Icons (aws-architecture-icons): 249 icons (CloudSearch, EMR, DynamoDB, S3, EC2, Lambda, VPC, RDS, Kinesis, etc.)

2. Google Icons (google-icons): 139 icons (Anthos, BigQuery, Compute Engine, Cloud Run, GKE, Firestore, etc.)

3. System Design Components (system-design-components): 24 items (Application server, Multi-instance server, Load Balancer, etc.)

4. Shapes for UML & ER Diagrams (uml-er-diagrams): 21 items (Entities, Relations, Connectors, Shapes)

5. Software Logos (software-logos): 18 icons (Docker, JSON, Git, Database logos, etc.)

6. Architecture Diagram Components (architecture-diagram-components): 11 components (Slack, Docker, GitHub, VPC, Subnets)

7. Software Architecture (software-architecture): 7 core diagram elements

8. Robots (robots): 7 illustrated robot figures

9. Built-in Common Icons (built-in): 23 lightweight native icons

Auto-Layout Flowchart

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"]
    }
  }
}