Excalidraw Mcp

What is Excalidraw MCP?

Excalidraw MCP (Model Context Protocol) is a lightweight server that provides API functionality for managing Excalidraw drawings. It is a work-in-progress Node.js/TypeScript project that offers CRUD operations and export capabilities for Excalidraw files.

How to use Excalidraw MCP?

1. Clone and install:
   • git clone https://github.com/yourusername/excalidraw-mcp.git
   • npm install
   • npm run build
2. Start the server:
   • npm start
   • For development: npm run dev
3. Use the provided API endpoints to create, read, update, delete, list drawings and to export drawings to SVG, PNG or JSON.

Key features

• Create, read, update, delete (CRUD) Excalidraw drawings
• Export drawings to SVG, PNG, and JSON
• Simple file-based storage backend (no DB required)
• Implemented in Node.js/TypeScript with a clear project structure

Typical use cases

1. Host a lightweight backend for an Excalidraw-based app to persist drawings
2. Provide export endpoints for automated image generation or previews (SVG/PNG/JSON)
3. Integrate with other services or workflows that need programmatic access to Excalidraw files
4. Local or small-team deployments where a simple file storage backend is sufficient

FAQ

• Is this production-ready?

No — the project is marked as work in progress. Review the repository and tests before using in production.

• How do I run it locally?

Clone the repo, run npm install, build with npm run build, then start with npm start. For development, use npm run dev.

• What storage does it use?

A simple file-based storage system is used by default (no external database configured).

• What export formats are supported?

SVG, PNG, and JSON exports are provided.

• What license covers the project?

The project is licensed under MIT.

• How can I contribute?

Fork the repository, open issues or pull requests on the GitHub project (https://github.com/i-tozer/excalidraw-mcp).