Excalidraw · excalidraw — Claude Code MCP server: diagrams and setup
The Excalidraw MCP server creates hand-drawn diagrams inside a conversation. Use it when a flow, architecture, or abstract idea needs a visual form.
no license 269 installs updated 2026-02-06
claude mcp add --transport http excalidraw https://excalidraw.run.toolsWhat Excalidraw does
Excalidraw exposes two tools to the agent. read_me supplies the rules for Excalidraw elements, including color references and examples. create_view renders a hand-drawn diagram from those elements, sending them one at a time with a draw-on animation.
The order matters: call read_me before the first create_view request so the agent knows how to format the elements. The server uses the remote endpoint https://excalidraw.run.tools, so there is no local server command to run.
In Claude Code, add it with claude mcp add --transport http excalidraw https://excalidraw.run.tools. The same MCP server also has setup entries for Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
What it helps with
- draw a project architecture diagram
- map relationships between entities
- turn a complex idea into a visual sequence
- show a process as animated drawings
Example prompts for the agent
- Use
read_mefirst, then draw the data flow between the services in this project. - Create a hand-drawn architecture diagram with
create_view. - Visualize the user journey as a sequence of animated drawings.
How to install Excalidraw
Platform CLI: remote server
claude mcp add --transport http excalidraw https://excalidraw.run.toolsPlatform CLI: remote server
codex mcp add excalidraw --url https://excalidraw.run.toolsConfig file
{
"mcpServers": {
"excalidraw": {
"url": "https://excalidraw.run.tools"
}
}
}Config file
{
"servers": {
"excalidraw": {
"type": "http",
"url": "https://excalidraw.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http excalidraw https://excalidraw.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Excalidraw
How do I install Excalidraw in Claude Code?
Run claude mcp add --transport http excalidraw https://excalidraw.run.tools. This adds the MCP server over HTTP.
What does Excalidraw do?
It creates hand-drawn diagrams and visual illustrations inside the conversation. Its create_view tool renders the elements with a draw-on animation.
Why should read_me run before create_view?
read_me gives the agent the element format reference, color information, and examples. Call it before the first create_view request.
Similar MCP servers
All MCP servers for Design →Excalidraw by other authors comes first.