excalidraw-mcp

excalidraw-mcp

18
developer_tools

The Excalidraw MCP Server allows users to manipulate and manage Excalidraw drawings via an API, offering functionality to create, update, delete, and export drawings in various formats. The server simplifies interaction with Excalidraw drawings, enhancing operability and efficiency for developers.

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 drawing
  • get_drawing: Get an Excalidraw drawing by ID
  • update_drawing: Update an Excalidraw drawing by ID
  • delete_drawing: Delete an Excalidraw drawing by ID
  • list_drawings: List all Excalidraw drawings
Export Operations
  • export_to_svg: Export an Excalidraw drawing to SVG
  • export_to_png: Export an Excalidraw drawing to PNG
  • export_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