← all repositories
yctimlin/mcp_excalidraw

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.

2.4k stars TypeScript Coding AssistantsAgents
mcp_excalidraw
Velocity · 7d
+4.0
★ / day
Trend
steady
star history

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, and group/ungroup
  • Canvas snapshots (snapshot_scene / restore_snapshot) and file I/O (export_scene / import_scene)
  • create_from_mermaid for importing Mermaid diagrams
  • read_diagram_guide embeds best-practice color palettes, sizing rules, and anti-patterns to improve AI output quality
  • export_to_excalidraw_url encrypts 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.