Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

excalidraw-mcp

MCP.Pizza Chef: i-tozer

The excalidraw-mcp is a Model Context Protocol server that provides API functionality to create, read, update, delete, and export Excalidraw drawings. It supports exporting drawings to SVG, PNG, and JSON formats and uses a simple file-based storage system. This server enables seamless integration of Excalidraw drawing management into MCP-enabled workflows and applications.

Use This MCP server To

Create new Excalidraw drawings via API calls Retrieve and display Excalidraw drawings by ID Update existing Excalidraw drawings programmatically Delete Excalidraw drawings from storage List all stored Excalidraw drawings for management Export drawings to SVG format for vector graphics use Export drawings to PNG format for raster image use Export drawings to JSON for data interchange or backup

README

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

excalidraw-mcp FAQ

How do I start the excalidraw-mcp server?
Clone the repository, install dependencies with npm install, build with npm run build, then start the server using npm start.
What export formats does excalidraw-mcp support?
It supports exporting drawings to SVG, PNG, and JSON formats for versatile usage.
How are drawings stored in excalidraw-mcp?
Drawings are stored using a simple file-based storage system for easy management and access.
Can I update an existing drawing through the API?
Yes, the server provides an update_drawing endpoint to modify drawings by their ID.
Is it possible to list all drawings stored in the server?
Yes, the list_drawings endpoint returns all stored Excalidraw drawings.
Does excalidraw-mcp support deleting drawings?
Yes, you can delete drawings by ID using the delete_drawing API endpoint.
What programming languages or frameworks are required to use excalidraw-mcp?
The server is built with Node.js and requires npm for dependency management and running scripts.
Can excalidraw-mcp be integrated with other MCP clients?
Yes, it is designed as an MCP server to integrate seamlessly with MCP clients and workflows.