i-tozer/excalidraw-mcp
If you are the rightful owner of excalidraw-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a Model Context Protocol (MCP) server for Excalidraw, providing API functionality for operating on Excalidraw drawings.
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