Excalidraw Mcp
- 4 repo stars
- Updated November 29, 2025
- cmd8/excalidraw-mcp
Excalidraw MCP is a MCP server that lets coding agents work against a local Excalidraw diagram file you specify at install time.
About
io.github.cmd8/excalidraw-mcp is a stdio Model Context Protocol server that connects AI coding agents to a specific Excalidraw diagram file on disk. developers who already sketch systems in Excalidraw can register the server with a required diagram path argument so the agent can reason about and update shapes, arrows, and labels without leaving the editor workflow. The integration is intentionally file-based: you pass /path/to/diagram.excalidraw at install time, which keeps diagrams versionable next to your repo. It is not a full collaborative canvas replacement; it is agent tooling for one diagram file at a time. Intermediate setup assumes Node/npm MCP config and a local Excalidraw export you want the agent to maintain.
- 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
Excalidraw Mcp by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcp /path/to/diagram.excalidrawAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 4 |
|---|---|
| Package | @cmd8/excalidraw-mcp |
| Transport | STDIO |
| Auth | None |
| Last updated | November 29, 2025 |
| Repository | cmd8/excalidraw-mcp ↗ |
What it does
Let your coding agent read and edit local Excalidraw diagram files so architecture sketches and flowcharts stay in sync with implementation notes.
Who is it for?
Best when you keep system diagrams in Excalidraw on disk and want Claude Code or Cursor to update them while coding.
Skip if: Skip if you need real-time multiplayer whiteboarding or cloud-only Excalidraw without a local file path.
What you get
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
By the numbers
- Server version 1.2.0
- npm package @cmd8/excalidraw-mcp
- stdio transport
README.md
@cmd8/excalidraw-mcp
Model Context Protocol (MCP) server for Excalidraw diagrams.
🛠️ Installation
Requirements
- Node.js >= v18.0.0
Install in Cursor
Add to your Cursor MCP config (~/.cursor/mcp.json):
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
Install in Claude Code
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
Install in Amp
amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
Install in VS Code
Add to your VS Code MCP settings:
{
"mcp": {
"servers": {
"excalidraw": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
}
Install in Windsurf
Add to your Windsurf MCP config:
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
Install in Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
Install in OpenAI Codex
Add to your Codex MCP config:
[mcp_servers.excalidraw]
command = "npx"
args = ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
CLI Options
-d, --diagram(required): Path to the Excalidraw diagram file
🔨 Available Tools
createNode
Create a new node (shape with label) in the diagram. Returns the created node ID.
createEdge
Create an arrow connecting two nodes. Nodes can be referenced by ID or by label text.
deleteElement
Delete a node or edge from the diagram by ID or label.
getFullDiagramState
Returns a markdown representation of the complete diagram, including nodes, relationships, labels, frames, and colors.
License
MIT
Recommended MCP Servers
0piFree, 2hr expiry agent storage to cache contexts, bridge workflows, or dump data.
100Hires AI ATS & Recruitment SoftwareOfficial 100Hires MCP: AI ATS & Recruitment Software for candidates, jobs, applications, interviews.
123elec McpInterface MCP officielle du site marchand 123elec, catalogue, stock, panier, commandes.
1stayHotel booking MCP server.2
2D Assets MCPMCP server for generating advanced mock 2D PNG assets for game prototypes.43D MeshWeaverMesh spatial optimizer reducing geometric overhead in 3D assets.How it compares
File-backed diagram MCP integration, not a standalone diagramming web app or agent skill.
FAQ
Who is Excalidraw MCP for?
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.