Excalidraw MCP Server
Provides tools for creating, reading, updating, and deleting Excalidraw drawings, with export capabilities to SVG, PNG, and JSON formats using a file-based storage system.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Excalidraw MCP Server create a flowchart for our login process"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Excalidraw MCP Server
A Model Context Protocol (MCP) server for Excalidraw.
Features
Create, read, update, and delete Excalidraw drawings
Export drawings to SVG, PNG, and JSON formats
Simple file-based storage system
Only supports
stdio
Related MCP server: excalidraw
Usage
The command to use in MCP configs is:
docker run --rm --interactive --volume "$(pwd)/.excalidraw:/app/storage" andreswebs/excalidraw-mcpNote the --volume flag: the /app/storage directory from the container must be mounted locally to access the drawings.
Example config for GitHub Copilot / VSCode:
.vscode/mcp.json:
{
"servers": {
"excalidraw": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"--rm",
"--interactive",
"--volume",
"${workspaceFolder}/.excalidraw:/app/storage",
"andreswebs/excalidraw-mcp"
]
}
}
}Tools
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
Acknowledgements
This project was originally forked from i-tozer/excalidraw-mcp.
It also drew inspiration from yctimlin/mcp_excalidraw.
Authors
Andre Silva - @andreswebs
License
This project is licensed under the Unlicense.
Available Tools
8 toolscreate_drawingC
Create a new Excalidraw drawing
Inputs: name (required), content (required).
delete_drawingB
Delete an Excalidraw drawing by ID
Inputs: id (required).
export_to_jsonC
Export an Excalidraw drawing to JSON
Inputs: id (required).
export_to_pngC
Export an Excalidraw drawing to PNG
Inputs: id (required), quality, scale, exportWithDarkMode, +1 more.
export_to_svgC
Export an Excalidraw drawing to SVG
Inputs: id (required).
get_drawingC
Get an Excalidraw drawing by ID
Inputs: id (required).
list_drawingsC
List all Excalidraw drawings
Inputs: page, perPage.
update_drawingC
Update an Excalidraw drawing by ID
Inputs: id (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool targets a specific action (create, delete, export, get, list, update) on a specific resource (drawing), making it easy for an agent to select the correct tool without confusion.
All tools follow a consistent verb_noun pattern (e.g., create_drawing, delete_drawing, export_to_json). The naming is uniform across all eight tools, with no deviations in style or convention.
With 8 tools, this server is well-scoped for managing Excalidraw drawings. Each tool serves a distinct and necessary function, covering core operations without being overly sparse or bloated.
The tool set provides complete CRUD/lifecycle coverage for the domain: create, get, list, update, and delete drawings, plus multiple export options. There are no obvious gaps, and agents can perform all essential workflows without dead ends.
Maintenance
Related MCP Connectors
Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.
Create, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.
Create, edit and organize hand-drawn diagrams (flowcharts, ER, architecture) from any AI agent.
Saves the diagrams your AI draws and gives you a link to share. Edits update the same link.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to programmatically generate, edit, and view Excalidraw diagrams with real-time browser synchronization. It provides a suite of tools for adding shapes, text, and arrows to diagrams through natural language interactions.113,455 npm102MIT
- AlicenseNot gradedqualityDmaintenanceProvides tools for creating, deleting, and querying nodes and edges in Excalidraw diagrams, enabling diagram editing via LLM interfaces.902 npm5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to build, edit, organize, and export Excalidraw diagrams (architecture, flowcharts, etc.) entirely headless, producing .excalidraw files, SVG, and PNG renders.3,455 npmMIT
- FlicenseNot gradedqualityDmaintenanceGenerates hand-drawn Excalidraw diagrams from natural language prompts or structured descriptions, with tools for creating, listing, and opening diagrams directly in the browser.-