Pod to App: Claude Code
How to install Excalidraw MCP in Claude Code
By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Excalidraw MCP's own docs on 11 Nov 2026
The short answer
Run claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server. The canvas starts by itself at http://127.0.0.1:3000, where you can watch Claude Code draw. No account or API key is needed.
claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server- Needs
- Node.js 20 or newer
- Canvas
- http://127.0.0.1:3000
- Tools
- 27
- Price
- Free, MIT
Install it step by step
- Step 1: Check
node --versionis 20 or newer. - Step 2: Run the command at the top of this page.
--scope usermakes it available in every project. - Step 3: Start Claude Code and run
/mcpto see excalidraw connected. - Step 4: Open
http://127.0.0.1:3000if you want to watch (optional). - Step 5: Ask: "Draw the architecture of this service as an Excalidraw diagram, check it for overlaps, and export it to docs/architecture.excalidraw."
MCP server or skill?
This project is unusual: its README says that for coding agents, the bundled skill plus its command line tool often works better than MCP, because there is nothing to configure and it uses fewer tokens. Both drive the same canvas.
| Route | Install | Pick it when |
|---|---|---|
| MCP server | claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server | You want the tools listed in /mcp like your other servers |
| Skill | npx -y mcp-excalidraw-server install-skill | You want the lightest setup; it installs to ~/.claude/skills |
Why Claude Code draws better with this one
Excalidraw also has an official MCP that drops a one-shot diagram into the chat. This server is a workbench instead: Claude Code can create, read, move and delete single elements, then look at its work with describe_scene and get_canvas_screenshot, and fix cut-off labels or crossed arrows before it says it is done.
- Export
.excalidrawfiles into the repo, so diagrams are reviewed and updated with the code. - Turn a Mermaid diagram into an editable Excalidraw one with
create_from_mermaid. - Take named snapshots and roll back if a change goes wrong.
- Save a
.excalidraw.mdfile straight into an Obsidian vault.
Keep diagrams after a restart
By default the canvas lives in memory, so restarting clears it. Set a data folder to recover elements and snapshots, and choose where file tools may write:
claude mcp add excalidraw --scope user -e EXCALIDRAW_DATA_DIR=$HOME/.excalidraw-mcp -e EXCALIDRAW_EXPORT_DIR=$HOME/diagrams -- npx -y mcp-excalidraw-serverIf it does not work
| What you see | What to do |
|---|---|
| Mermaid conversion fails | That one feature lays out in the browser. Open http://127.0.0.1:3000 and try again. |
| Export refused | File tools only write inside EXCALIDRAW_EXPORT_DIR, which defaults to the folder Claude Code started in. |
| Canvas is blank after a restart | Expected without EXCALIDRAW_DATA_DIR. Export important diagrams to files. |
| Port 3000 already in use | Set PORT to another number and EXPRESS_SERVER_URL to match. |
MCP Shelf take
Is Excalidraw MCP worth adding to Claude Code?
This is the diagram server we would give a coding agent. Because Claude Code can screenshot the canvas and fix its own layout, the results are far tidier than one-shot diagrams, and exporting .excalidraw files means diagrams live in the repo next to the code they describe. Try the skill route first, as the project itself suggests; switch to the MCP server if you prefer seeing the tools in /mcp. Keep the canvas on localhost: it has no login.
Sophie Filer
Questions
Is this the official Excalidraw MCP?
No. It is a separate open-source project (yctimlin/mcp_excalidraw). The official one shows a diagram inside the chat; this one gives the agent a live canvas with element-level editing, screenshots and file export.
Do I need an Excalidraw account or API key?
No. Drawing runs locally. Only the optional share feature uploads an encrypted copy to excalidraw.com.
Can Claude Code see the diagram it drew?
Yes. describe_scene returns a text summary and get_canvas_screenshot returns an image, so it can spot overlaps and cut-off labels and fix them.
Sources: the steps on this page are written in our own words from Excalidraw MCP's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.
