excalidraw-mcp-server — Claude Code skill: stream Excalidraw diagrams
A skill that walks an agent through building MCP servers which hand back interactive hand-drawn Excalidraw diagrams, streaming updates included.
no license 235 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a claude-codeWhat excalidraw-mcp-server does
Treat this as a build guide. The agent reads it and writes an MCP server that answers tool calls with an HTML app instead of plain text, going through the MCP Apps extension. A diagram travels as Excalidraw scene JSON: an elements array plus appState. Rectangle and text shapes are spelled out field by field, so the code it generates compiles as written.
Two deployment routes are covered. Point a client at the hosted server on https://mcp.excalidraw.com, or run your own Node.js process, either on the machine or as a Vercel function. The local route starts with pnpm install && pnpm run build, because the Claude Desktop config launches node against dist/index.js with the --stdio flag and that file only exists after the build.
What lands in the chat is view-only until someone clicks it, which opens a fullscreen modal editor. A misplaced box or label gets fixed by hand, without another round trip to the model.
What it helps with
- return an HTML app from an MCP tool call instead of plain text
- describe an Excalidraw scene from rectangles and labels
- stream a diagram as it grows and steer the viewport
- deploy the server locally on Node.js or as a Vercel function
- wire the server into Claude Desktop through
claude_desktop_config.json
Example prompts for the agent
- Build an MCP server whose
draw_diagramtool returns an interactive Excalidraw diagram - Add hand-drawn block-diagram rendering with streaming updates to my MCP tool
- Show me how to wrap an Excalidraw scene in an HTML response with mimeType
text/html
How to install excalidraw-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/excalidraw-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/excalidraw-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a codex2Manually: put the files in place
.agents/skills/excalidraw-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/excalidraw-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/excalidraw-mcp-server2Manually: put the files in place
.github/skills/excalidraw-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/excalidraw-mcp-serverManually: put the files in place
.devin/skills/excalidraw-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about excalidraw-mcp-server
How do I install excalidraw-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a claude-code. The skill file lands at ~/.claude/skills/excalidraw-mcp-server/SKILL.md.
What does excalidraw-mcp-server do?
It teaches an agent to write a TypeScript MCP server that returns an HTML app holding an Excalidraw canvas, rather than a text answer. The scene format, the element shapes and the server skeleton are all part of it.
Can I skip building my own server?
Yes. A hosted endpoint already runs at https://mcp.excalidraw.com, and its URL is enough inside mcpServers. The skill matters when the server is yours or the diagrams belong inside your own MCP tool.