MCP Excalidraw

🚀 Excalidraw MCP Server: Powerful Drawing API with LLM Integration

A powerful Excalidraw MCP server equipped with a drawing API that supports seamless LLM integration.

🚀 Quick Start

The Excalidraw MCP Server is a comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and illustrations. It offers a structured and developer - friendly API for Large Language Models (LLMs), allowing them to create, modify, query, and manipulate Excalidraw drawings.

✨ Features

• Full - fledged Excalidraw Element Control: Supports creating, updating, deleting, and querying any Excalidraw element.
• Advanced Element Operations: Enables aligning, distributing, locking, and unlocking elements.
• Resource Management: Allows access to and modification of scene information, libraries, themes, and elements.
• Easy Integration: Compatible with Claude Desktop and other LLM platforms.
• Docker Integration: Supports deployment via Docker.

📚 Documentation

API Tool Reference

💻 Usage Examples

Basic Usage

{
  "type": "rectangle",
  "x": 100,
  "y": 100,
  "width": 200,
  "height": 100,
  "backgroundColor": "#ffffff",
  "strokeColor": "#000000",
  "strokeWidth": 2,
  "roughness": 1
}

This is an example of creating a rectangular element.

{
  "type": "rectangle",
  "filter": {
    "strokeColor": "#000000"
  }
}

This is an example of querying a specific element.

{
  "elementIds": ["elem1", "elem2", "elem3"]
}

This is an example of combining multiple elements.

Integration Guide

Integration with Claude Desktop

Add the following configuration to the config.json file:

{
  "excalidrawMCP": {
    "enabled": true,
    "serverUrl": "http://localhost:8080"
  }
}

Integration with Cursor

Create a .mcp.json configuration file with the following content:

{
  "integrations": {
    "excalidrawMCP": {
      "enable": true,
      "options": {
        "serverHost": "localhost",
        "port": 8080
      }
    }
  }
}

⚠️ Important Note

• Ensure that the server address and port are configured correctly.
• Refer to the full integration documentation for more details.

Docker Deployment Guide

1. Pull the Image

docker pull excalidraw/mcp-server:latest

2. Start the Container

docker run -p 8080:8080 --name excalidraw-mcp excalidraw/mcp-server:latest

Configuration Options

📄 License

This Excalidraw MCP Server is released under the MIT License. You are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.