Excalidraw MCP Server
This is a Model Context Protocol (MCP) server for Excalidraw, providing API functionality for operating on Excalidraw drawings.
Features
- Create, read, update, and delete Excalidraw drawings
- Export drawings to SVG, PNG, and JSON formats
- Simple file-based storage system
Installation
# Clone the repository
git clone https://github.com/yourusername/excalidraw-mcp.git
cd excalidraw-mcp
# Install dependencies
npm install
# Build the project
npm run build
Usage
Starting the Server
API Endpoints
The server provides the following tools:
Drawing Management
create_drawing
: Create a new Excalidraw drawingget_drawing
: Get an Excalidraw drawing by IDupdate_drawing
: Update an Excalidraw drawing by IDdelete_drawing
: Delete an Excalidraw drawing by IDlist_drawings
: List all Excalidraw drawings
Export Operations
export_to_svg
: Export an Excalidraw drawing to SVGexport_to_png
: Export an Excalidraw drawing to PNGexport_to_json
: Export an Excalidraw drawing to JSON
Development
Project Structure
excalidraw-mcp/
├── src/
│ ├── common/
│ │ └── errors.ts
│ └── operations/
│ ├── drawings.ts
│ └── export.ts
├── index.ts
├── package.json
├── tsconfig.json
└── README.md
Building
Running in Development Mode
License
MIT