+5
日增长
5,679
stars
546
forks
15
watchers
63
prs
49
issues
5
releases
README
Excalidraw MCP App Server
MCP server that streams hand-drawn Excalidraw diagrams with smooth viewport camera control and interactive fullscreen editing.
!Demo
Install
Works with any client that supports MCP Apps — Claude, ChatGPT, VS Code, Goose, and others. If something doesn't work, please open an issue.
Remote (recommended)
https://mcp.excalidraw.com
For apps that don't yet have an official integration, you can add a custom MCP / connector (naming can vary between apps).
Local
Option A: Download Extension
1. Download excalidraw-mcp-app.mcpb from Releases
2. Double-click to install in Claude Desktop
Option B: Build from Source
bash
git clone https://github.com/excalidraw/excalidraw-mcp.git
cd excalidraw-mcp-app
pnpm install && pnpm run build
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
json
{
"mcpServers": {
"excalidraw": {
"command": "node",
"args": ["/path/to/excalidraw-mcp-app/dist/index.js", "--stdio"]
}
}
}
Restart Claude Desktop.
Usage
Example prompts:
- "Draw a cute cat using excalidraw"
- "Draw an architecture diagram showing a user connecting to an API server which talks to a database"
What are MCP Apps and how can I build one?
Text responses can only go so far. Sometimes users need to interact with data, not just read about it. MCP Apps is an official Model Context Protocol extension that lets servers return interactive HTML interfaces (data visualizations, forms, dashboards) that render directly in the chat.
- Getting started for humans: documentation
- Getting started for AIs: skill
Contributing
PRs welcome! See Local above for build instructions.
Deploy your own instance
You can deploy your own copy to Vercel in a few clicks:
1. Fork this repo
2. Go to vercel.com/new and import your fork
3. No environment variables needed — just deploy
4. Your server will be at https://your-project.vercel.app/mcp
Release checklist
For maintainers
bash
1. Bump version in manifest.json and package.json
2. Build and pack
pnpm run build && mcpb pack .
3. Create GitHub release
gh release create v0.3.0 excalidraw-mcp-app.mcpb --title "v0.3.0" --notes "What changed"
4. Deploy to Vercel
vercel --prod
Credits
Built with Excalidraw — a virtual whiteboard for sketching hand-drawn like diagrams.
License
MITTop issues
#30Upload to excalidraw+6 comments · 2026-02-14#4insert jpeg/png image ability5 comments · 2026-02-07#33Make arrow-to-shape binding easier for AI agents (and document the mechanism)3 comments · 2026-02-15#31export as png3 comments · 2026-02-14#17Diagram is not visible on Cursor3 comments · 2026-02-12#13I can't see the preview animation of the draw.3 comments · 2026-02-09#29add an update_view to edit diagram created using create_view2 comments · 2026-02-14#22`export_to_excalidraw` drops all text elements2 comments · 2026-02-13
Latest release
v0.3.2 v0.3.2 2026-02-09- Updated cheat sheet: replaced storyboard example with MCP Apps sequence diagram - Added cameraUpdate and delete pseudo-elements to Element Types reference - Updated demo GIF