Skip to content
MCP Shelf

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.

Terminal
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

  1. Step 1: Check node --version is 20 or newer.
  2. Step 2: Run the command at the top of this page. --scope user makes it available in every project.
  3. Step 3: Start Claude Code and run /mcp to see excalidraw connected.
  4. Step 4: Open http://127.0.0.1:3000 if you want to watch (optional).
  5. 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.

RouteInstallPick it when
MCP serverclaude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-serverYou want the tools listed in /mcp like your other servers
Skillnpx -y mcp-excalidraw-server install-skillYou 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 .excalidraw files 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.md file 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:

Terminal
claude mcp add excalidraw --scope user -e EXCALIDRAW_DATA_DIR=$HOME/.excalidraw-mcp -e EXCALIDRAW_EXPORT_DIR=$HOME/diagrams -- npx -y mcp-excalidraw-server

If it does not work

What you seeWhat to do
Mermaid conversion failsThat one feature lays out in the browser. Open http://127.0.0.1:3000 and try again.
Export refusedFile tools only write inside EXCALIDRAW_EXPORT_DIR, which defaults to the folder Claude Code started in.
Canvas is blank after a restartExpected without EXCALIDRAW_DATA_DIR. Export important diagrams to files.
Port 3000 already in useSet 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.