Excalidraw Architect MCP
Excalidraw Architect MCP stores a specification inside an editable diagram, so agents can revise the structure and rebuild it.
- 163 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server creates and edits diagram files in directories accessible to its process.
Install
- Works in
Manual install
pip install excalidraw-architect-mcpFirst Quick Start command. PNG support uses a separate installation option.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server creates and edits diagram files in directories accessible to its process.
This is third-party code. Review the repository files before installing.
What it does
Excalidraw Architect MCP builds diagrams from an agent’s structured description. The agent selects a diagram type and fills its fields, such as components and connections for architecture or participants for a message sequence. The server computes the layout and saves an editable `.excalidraw` file. Other types include processes and timelines. Results can be exported to SVG; PNG needs an optional dependency. The server runs locally without API keys, while the diagram content remains available to the connected model in its usual environment.
Who it is for. Technical documentation authors needing diagrams that remain editable as systems change.
Good fit when
- An architect describes a service through components and connections.
- An incident review uses a message sequence or timeline.
- An agent updates an existing diagram from its saved specification.
- A technical writer publishes SVG and keeps the editable source for later updates.
Not a fit when
- You need free-form artwork without a structural specification.
- Automatic layout must guarantee readability for any overloaded diagram.
- PNG export is required without its optional dependency.
Example request
Create a user-login sequence diagram, save the editable source and SVG, then inspect labels and connection overlaps.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Each diagram type has a specific schema; inspect required fields before generation. Editing lists replaces the whole list, so an incomplete patch can remove existing specification elements. PNG export requires an optional dependency, while SVG works in the base installation. Files are written locally, but content is shared with the calling agent; check whether the chosen model is permitted to receive details of an internal architecture.
How to disable. Remove the MCP entry and stop the process. Saved `.excalidraw`, SVG and PNG files remain accessible.
FAQ
Can I edit the file manually?
Yes. Open the `.excalidraw` file in Excalidraw and save your edits.
Does the server need an API key?
No. Local generation needs none; configure the model separately in the client.
How do I choose a specification format?
Call `get_diagram_schema` for the required type. The result lists required fields to supply before generating components and connections.
Why does PNG export fail?
The `[png]` extra adds cairosvg. Follow the [Quick Start installation](https://github.com/bv-venky/excalidraw-architect-mcp#quick-start) with that extra; the base package exports SVG.
Can I patch one list item?
Send the complete revised list because list patches replace it entirely.
Discussion
No questions or reviews yet.
Related
MCP serversExcalidraw MCP Server
Excalidraw MCP Server, CLI & Agent Skill
A live Excalidraw canvas for the agent: creates, edits and exports diagrams over MCP or CLI, sees its own work via screenshots and saves .excalidraw files into
Excalidraw CLI renders .excalidraw files and Mermaid diagrams to PNG and SVG locally with no account, and gives agents JSON.
The official draw.io MCP server: an agent builds diagrams from XML or Mermaid and opens them in the draw.io editor
Smart Drawio
Smart Drawio Next
An MCP server and skill for editable draw.io diagrams: an agent generates XML from a prompt, validates references, repairs tags and applies themes
excalidraw-cli turns a text description, JSON or Graphviz DOT into an editable Excalidraw diagram and exports PNG and SVG for agents
A skill that draws an Excalidraw-style diagram from a text prompt and returns an editor link, an animation and a PNG.
README in short
Architecture diagrams can use a separate Markdown system model. Agents render different views and check it for dependency cycles, single points of failure and disconnected services. Diagram-type guidance is available through MCP and a separate skill.