What is excalidrawer?
excalidrawer is a code-first diagram generator, not Excalidraw itself. Its MCP server exposes render_diagram and compute_layout tools, so an agent builds a flowchart, architecture, sequence, timeline, comparison or tree diagram from element data and layout helpers, then gets back a real, still-editable .excalidraw file alongside SVG and PNG exports for docs or CI.
Excalidraw is a drawing tool you arrange by hand on a canvas. excalidrawer is a generation tool: it takes element data and layout instructions and writes a real, hand-drawn-style diagram without anyone opening a canvas.
That distinction matters for pipelines. A generated .excalidraw file can go through version control, regenerate the same way every time, and run inside a CI job that builds documentation, none of which works with a diagram someone dragged into place by hand.
The six diagram types
- Flowchart, for decision flows with branching logic.
- Architecture, for layered components and system topology.
- Sequence, for multi-actor interactions and message flows.
- Timeline, for milestones, roadmaps and project phases.
- Comparison, for a side-by-side A versus B layout, and tree, for hierarchies that split left to right or top to bottom.
How the two tools work together
compute_layout takes a layout helper, such as grid, chain, swimlane, hub-and-spoke or tree, and returns coordinates for a set of elements. render_diagram then takes those elements and writes .excalidraw, SVG and PNG output in one call.
Who it is for
Best for
- Documentation and CI pipelines that need a diagram to regenerate the same way every build, not redrawn by hand each time.
- Agent workflows that already have structured data about a system and want a diagram built straight from it.
- Teams who want architecture or sequence diagrams under version control alongside the code they describe.
Not for
- If the architecture diagram needs real AWS, Azure or GCP vendor icons rather than plain hand-drawn shapes, Excalidraw Icons MCP draws that diagram with those icons.
- When plain English or Mermaid should turn into one animated flow diagram instead of a static render, Dashmotion Skill builds that animated architecture diagram directly.
- If what you need is an animated SVG from a JSON config rather than a diagram file, nakkas MCP Server renders that animated SVG locally instead.
- When the output should be a full HTML page with diagrams and tables rather than a single diagram file, Visual Explainer Skill writes that HTML page instead.
Use it with UiChemy
excalidrawer produces a standalone diagram asset, not a web page layout. Once that diagram is exported as an image, UiChemy Composer can place it inside an editable WordPress page. Click Get Started on uichemy.com.
Connect excalidrawer MCP: Generate Excalidraw Diagrams by Code to your AI client
claude mcp add excalidrawer -- npx -y -p excalidrawer@latest -c excalidrawer-mcpRegister the MCP server in Claude Code
Run
claude mcp add excalidrawer -- npx -y -p excalidrawer@latest -c excalidrawer-mcp. Codex uses the same arguments withcodex mcp add.Or install the agent plugin
In Claude Code run
/plugin marketplace add guohaonan-shy/excalidrawerthen/plugin install excalidrawer@excalidrawer-dev. Codex has matchingcodex plugincommands.Or install the CLI directly
Run
npm install -g excalidrawerfor command-line use, ornpm install excalidrawerto call it as a library from your own code.Ask for a diagram
Describe the system or flow you want, naming one of the six diagram types, and let the agent call compute_layout and render_diagram to produce the files.
Client configuration
{
"mcpServers": {
"excalidrawer": {
"command": "npx",
"args": ["-y", "-p", "excalidrawer@latest", "-c", "excalidrawer-mcp"]
}
}
}Endpoints and ports
claude mcp add excalidrawer -- npx -y -p excalidrawer@latest -c excalidrawer-mcpRegisters the server with Claude Code directly.excalidrawer render -i elements.json -o docs/diagramRenders element data to .excalidraw, SVG or PNG from the command line.excalidrawer compute-layout --helper gridLayoutComputes coordinates for a set of elements using a named layout helper.What you can do with it
- Six diagram typesFlowchart, architecture, sequence, timeline, comparison and tree diagrams all come from the same two-tool pipeline.
- Real, editable outputEvery generated diagram is a genuine .excalidraw file, so a person can still open and adjust it by hand afterward.
- Deterministic regenerationThe same element data and layout helper produce the same diagram every time, which plain canvas drawing cannot promise.
- Layout helper libraryGrid, chain, swimlane, hub-and-spoke and tree layout helpers handle coordinate math so the agent only supplies structure, not pixel positions.
- Three export formatsEach render call can produce .excalidraw, SVG and PNG together, covering an editable source and two static formats in one step.
- Three install pathsWorks as an agent plugin, a direct MCP server registration, or a plain CLI and library install, so a team can pick whichever path fits its workflow.
Tools it exposes
render_diagram
Outputs .excalidraw, SVG and PNG files from an array of elements in one call.
compute_layout
Generates coordinates for a set of elements using a layout helper such as grid, chain, swimlane, hub-and-spoke or tree.
Frequently asked questions
What is excalidrawer?
It is a code-first diagram generator that writes real, editable .excalidraw files, SVG and PNG exports from structured element data, rather than a canvas you draw on by hand like Excalidraw itself.
How do I set up the excalidrawer MCP server?
Run claude mcp add excalidrawer -- npx -y -p excalidrawer@latest -c excalidrawer-mcp in Claude Code, or codex mcp add with the same arguments in Codex, to register the server directly.
Which diagram types can excalidrawer generate?
Flowchart, architecture, sequence, timeline, comparison and tree diagrams, each built from the same render_diagram and compute_layout tool pair rather than a separate tool per diagram type the agent has to learn.
How is excalidrawer different from Excalidraw?
Excalidraw is a drawing tool for arranging boxes by hand on a canvas. excalidrawer is a generation tool that writes the same kind of diagram from code, so it fits version control, CI and repeat builds.
Can I still edit the diagram after it is generated?
Yes. The output is a genuine .excalidraw file, so opening it in Excalidraw afterward and adjusting it by hand works exactly as it would for any other Excalidraw file someone drew from scratch.
Can I install it as a plain CLI instead of an agent plugin?
Yes. Run npm install -g excalidrawer for a command-line tool with render and compute-layout commands, or npm install excalidrawer to use it as a library from your own code, with no agent plugin required at all.
Does excalidrawer work with agents other than Claude?
Yes. The README gives matching install paths for Claude Code and Codex, both as an agent plugin and as a direct MCP server registration, since the underlying server speaks standard MCP.


