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
npm start
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
npm run build
Running in Development Mode
npm run dev
License
MIT