Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • argocd-mcp
  • Xano MCP Server for Smithery
  • Powertools MCP Search Server
  • SQLite MCP Server
  • Vertex AI MCP Server
Back to MCP Servers
Excalidraw MCP Server

Excalidraw MCP Server

Public
Abdullah007bajwa/mcp_excalidraw

Model Context Protocol server enabling Large Language Models to create, modify, query, and manage Excalidraw diagrams with full element control, scene management, grouping, alignment, and export capabilities via a developer-friendly API.

javascript
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Excalidraw MCP Server

MCP Server

Unlock the full potential of Excalidraw MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Excalidraw MCP Server: Powerful Drawing API for LLM Integration

A comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and drawings. This server provides LLMs (Large Language Models) with the ability to create, modify, query, and manipulate Excalidraw drawings through a structured, developer‑friendly API.

Features

  • Full Excalidraw Element Control
    Create, update, delete, and query any Excalidraw element (rectangle, ellipse, diamond, text, arrow, etc.), including support for:
    • position (x, y)
    • dimensions (width, height)
    • styling (backgroundColor, strokeColor, strokeWidth, roughness, opacity)
    • text (text, fontSize, fontFamily)
    • line geometry (points)
    • locking (locked flag)
  • Advanced Element Manipulation
    Group, ungroup, align, distribute, lock, and unlock elements.
  • Scene & AppState Management
    • Track and modify scene‑level state: theme, viewBackgroundColor, viewport (scroll & zoom), selectedElements, groups.
    • Retrieve library of all elements or individual scene properties.
  • Save Scene
    Export the current scene (elements + appState) to a .excalidraw file on disk.
  • Resource Management
    Access and modify scene information, element library, theme, and raw element data.
  • Easy Integration
    Compatible with Claude Desktop, Cursor, and any other LLM platforms that support MCP.
  • Docker Support
    Simple containerized deployment for zero‑dependency installs.

API Tools Reference

Element Creation and Modification

create_element

Create a new Excalidraw element.

  • Input
    { "type": "", "x": , "y": , "width": , "height": , "points": [{"x":,"y":}…], "backgroundColor": "", "strokeColor": "", "strokeWidth": , "roughness": , "opacity": , "text": "", "fontSize": , "fontFamily": "", "locked": }
  • Output
    { "id": "", "type": "", "created": true }

update_element

Update properties of an existing element.

  • Input
    { "id": "", }
  • Output
    { "id": "", "updated": true, "version": }

delete_element

Remove an element from the scene.

  • Input
    { "id": "" }
  • Output
    { "id": "", "deleted": true }

query_elements

List elements matching optional filters.

  • Input
    { "type": "", "filter": { "": } }
  • Output
    [ { /* element objects */ } … ]

Resource Management

get_resource

Retrieve scene or library information.

  • Input
    { "resource": "scene"|"library"|"theme"|"elements" }
  • Output
    • scene → { theme, viewport: {x,y,zoom}, selectedElements: […] }
    • library/elements → { elements: [ … ] }
    • theme → { theme: "light"|"dark" }

Element Organization

group_elements / ungroup_elements

Group or ungroup element collections.

  • Input
    { "elementIds": ["id1","id2",…] } { "groupId": "" }
  • Output
    { "groupId": "", "elementIds": […], "ungrouped": true? }

align_elements

Align multiple elements to specified edge or center.

  • Input
    { "elementIds": […], "alignment": "left"|"center"|"right"|"top"|"middle"|"bottom" }
  • Output
    { aligned: true, elementIds: […], alignment: "" }

distribute_elements

Evenly space elements horizontally or vertically.

  • Input
    { "elementIds": […], "direction": "horizontal"|"vertical" }
  • Output
    { distributed: true, elementIds: […], direction: "" }

lock_elements / unlock_elements

Prevent or allow editing of elements.

  • Input
    { "elementIds": [… ] }
  • Output
    { locked: true|false, elementIds: […] }

Scene Management

save_scene

Export current scene (elements + appState) to a .excalidraw file.

  • Input
    { "filename": "" }
  • Output
    Scene saved successfully to or error message.

Integration Examples

Claude Desktop

"mcpServers": { "excalidraw": { "command": "node", "args": ["src/index.js"], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } }

Cursor

Create .cursor/mcp.json:

{ "mcpServers": { "excalidraw": { "command": "node", "args": ["/absolute/path/to/mcp_excalidraw/src/index.js"], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } } }

Docker

docker run -i --rm mcp/excalidraw

Or in MCP config:

"mcpServers": { "excalidraw": { "command": "docker", "args": ["run", "-i", "--rm", "mcp/excalidraw"], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } }

Installation Guide

# Install dependencies npm install # Run development server npm start

Docker

docker build -t mcp/excalidraw . docker run -i --rm mcp/excalidraw

Configuration Options

Set via environment variables in .env or your container:

  • LOG_LEVEL — logging level (default: "info")
  • DEBUG — debug mode ("true"/"false", default: "false")
  • DEFAULT_THEME — default UI theme ("light"/"dark", default: "light")

Usage Examples

Create & Lock a Rectangle

{"type":"rectangle","x":50,"y":50,"width":100,"height":80,"backgroundColor":"#f3f3f3","strokeColor":"#333","locked":true} { "id":"abc123","type":"rectangle","created":true } {"elementIds":["abc123"]}

Save Scene to File

{"filename":"my_drawing.excalidraw"} "Scene saved successfully to my_drawing.excalidraw"
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • argocd-mcp
    argocd-mcp

    An MCP (Model Context Protocol) server integrating with the ArgoCD API to enable AI assistants and l...

    Added May 30, 2025
  • Xano MCP Server for Smithery
    Xano MCP Server for Smithery

    Model Context Protocol server enabling seamless integration between Claude AI and Xano databases wit...

    Added May 30, 2025
  • Powertools MCP Search Server
    Powertools MCP Search Server

    Model Context Protocol server enabling efficient local search of AWS Lambda Powertools documentation...

    2 tools
    Added May 30, 2025
  • SQLite MCP Server
    SQLite MCP Server

    A Model Context Protocol server enabling AI models to execute SQL queries, manage SQLite database sc...

    Added May 30, 2025
  • Vertex AI MCP Server
    Vertex AI MCP Server

    Provides a Model Context Protocol server enabling advanced interaction with Google Cloud's Vertex AI...

    20 tools
    Added May 30, 2025