An AI sketchpad with a memory and a feedback loop
It gives AI agents a live Excalidraw canvas with 26 tools to draw, see, and iteratively fix their own diagrams.

What it does
It runs a live Excalidraw canvas alongside an MCP server, letting AI agents create, read, update, and delete individual diagram elements through 26 programmatic tools. Unlike the official Excalidraw MCP—which renders a one-shot diagram inline in chat—this keeps a persistent, WebSocket-synced canvas that multiple agents can manipulate concurrently. It also works without an MCP client by falling back to a REST API via an agent skill.
The interesting bit
The killer feature is the closed feedback loop: agents can call describe_scene for structured text or get_canvas_screenshot for an actual image of the canvas, then adjust specific elements rather than regenerating the whole diagram from scratch. It is essentially turning a generative toy into a visual REPL.
Key highlights
- Full element-level CRUD with layout helpers like
align_elements,distribute_elements, andgroup/ungroup - Canvas snapshots (
snapshot_scene/restore_snapshot) and file I/O (export_scene/import_scene) create_from_mermaidfor importing Mermaid diagramsread_diagram_guideembeds best-practice color palettes, sizing rules, and anti-patterns to improve AI output qualityexport_to_excalidraw_urlencrypts and uploads scenes to excalidraw.com for sharing- Multi-agent support: several agents can draw on the same canvas at once
Caveats
- The canvas server binds to localhost by default and has no built-in authentication; exposing it requires network-level access controls
- Requires two running processes (canvas server + MCP server), so it is more infrastructure than a single binary
Verdict
Worth a look if you want AI agents to iteratively refine complex diagrams rather than spamming prompt variations. Skip it if you just need a quick one-off sketch from a chat prompt—the official Excalidraw MCP is already there for that.
Frequently asked
- What is yctimlin/mcp_excalidraw?
- It gives AI agents a live Excalidraw canvas with 26 tools to draw, see, and iteratively fix their own diagrams.
- Is mcp_excalidraw open source?
- Yes — yctimlin/mcp_excalidraw is open source, released under the MIT license.
- What language is mcp_excalidraw written in?
- yctimlin/mcp_excalidraw is primarily written in TypeScript.
- How popular is mcp_excalidraw?
- yctimlin/mcp_excalidraw has 2.4k stars on GitHub and is currently holding steady.
- Where can I find mcp_excalidraw?
- yctimlin/mcp_excalidraw is on GitHub at https://github.com/yctimlin/mcp_excalidraw.