Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill excalidraw-mcp-server -a claude-code
Open on GitHub

What 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_diagram tool 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-code

2Manually: put the files in place

~/.claude/skills/excalidraw-mcp-server/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/excalidraw-mcp-server/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set98

The whole set →
google-meta-ads-ga4-mcp google-meta-ads-ga4-mcp connects your assistant to an advertising MCP server for Google Ads, Meta Ads, and GA4. Useful for managing campaigns and pulling performance reports. CX Codex +1 240installs chrome-devtools-mcp-automation chrome-devtools-mcp-automation is a Claude Code skill for controlling Chrome through DevTools MCP. It applies to browser workflows, page debugging, and performance checks. CX Codex +1 239installs ableton-live-mcp-control ableton-live-mcp-control is a Claude Code skill that connects an agent to Ableton Live via MCP. It creates MIDI clips, adds tracks and devices, captures audio, and generates spectrograms in an open Live Set. CX Codex +1 237installs xiaohongshu-mcp-integration The xiaohongshu-mcp-integration skill connects an MCP server for Xiaohongshu to an AI coding agent, covering search, publishing, account actions, and content workflows. CX Codex +1 235installs awesome-mcp-servers-discovery awesome-mcp-servers-discovery — a skill that lets your agent search a curated catalogue of 6000+ MCP servers across 30+ categories and shows how to wire one up. CX Codex +1 233installs jcodemunch-mcp-code-retrieval The jcodemunch-mcp-code-retrieval skill lets an agent query repository symbols and their relationships through MCP. Use it to inspect a codebase by asking for specific implementations instead of browsing files line by line. CX Codex +1 230installs cve-mcp-server-security-intelligence cve-mcp-server-security-intelligence — a skill that runs a local MCP server and hands the agent 27 tools for CVE work: CVSS and EPSS scores, CISA KEV status, exploit hunting and a composite risk score. CX Codex +1 229installs claude-peers-mcp-inter-instance-messaging claude-peers-mcp-inter-instance-messaging — a skill that sets up the claude-peers MCP server so Claude sessions on one machine discover each other and exchange messages through a local broker. CX Codex +1 228installs

Project sponsors

Companies that keep this analytics open