Excalidraw Mcp
Let your coding agent read and edit local Excalidraw diagram files so architecture sketches and flowcharts stay in sync with implementation notes.
Overview
Excalidraw MCP is a Build-phase MCP server that lets coding agents work against a local Excalidraw diagram file you specify at install time.
What is this MCP server?
- stdio MCP server pointed at a single .excalidraw file path via required npm package argument
- npm package @cmd8/excalidraw-mcp v1.2.0 with Model Context Protocol schema 2025-10-17
- Targets local diagram files rather than a hosted whiteboard SaaS
- Pairs with Claude Code, Cursor, and other MCP-capable agents for iterative diagram edits
- Repository: github.com/cmd8/excalidraw-mcp
- Server version 1.2.0
- stdio transport
Community signal: 4 GitHub stars.
What problem does it solve?
You draw architecture in Excalidraw but your agent cannot see or update that file without manual copy-paste.
Who is it for?
Indie builders who keep system diagrams in Excalidraw on disk and want Claude Code or Cursor to update them while coding.
Skip if: Teams that need real-time multiplayer whiteboarding or cloud-only Excalidraw without a local file path.
What do I get? / Deliverables
After you add the server with your diagram path, the agent can treat that .excalidraw file as a living doc it can read and modify through MCP tools.
- MCP-connected access to one local Excalidraw diagram
- Agent-driven updates to diagram content on disk
- Versionable diagram artifacts alongside your repository
Recommended MCP Servers
Journey fit
Diagram work usually happens while you are actively building and documenting the product, not during early idea research alone. Excalidraw files map naturally to technical docs, system diagrams, and handoff artifacts that live beside the codebase.
How it compares
File-backed diagram MCP integration, not a standalone diagramming web app or agent skill.
Common Questions / FAQ
Who is Excalidraw MCP for?
Solo and indie developers using MCP-enabled agents who document systems in local Excalidraw files and want those diagrams agent-accessible.
When should I use Excalidraw MCP?
Use it during Build and docs work when architecture, sequence, or flow diagrams should stay aligned with code changes the agent is making.
How do I add Excalidraw MCP to my agent?
Install @cmd8/excalidraw-mcp via npm for stdio transport and set the required diagram argument to the full path of your .excalidraw file in your Claude Code or Cursor MCP config.