excalidraw-architect-mcp
Turn your architecture into a living, queryable knowledge graph - and render it as beautiful auto-laid-out Excalidraw diagrams. An MCP server for Cursor, Claude
What is excalidraw-architect-mcp?
Turn your architecture into a living, queryable knowledge graph - and render it as beautiful auto-laid-out Excalidraw diagrams. An MCP server for Cursor, Claude Code & Windsurf. Offline, no API keys.
Overview of excalidraw-architect-mcp
What it is
Excalidraw Architect MCP is an MCP server for Cursor, Claude Code, and Windsurf that generates Excalidraw diagrams from natural language descriptions. It separates the description of structure from layout computation, producing editable .excalidraw files with auto-layout. It runs offline and requires no API keys.
Key features
- 25 diagram types including architecture, flowcharts, sequence diagrams, state machines, ER models, swimlanes, timelines, Gantt charts, quadrants, funnels, and hand-sketched bar/line/scatter charts
- Genuinely hand-drawn output via a pure-Python port of the roughjs stroke generator
- Layout algorithms: Sugiyama with adaptive spacing for graphs; purpose-built geometry for other types
- Architecture-aware styling: 50+ technologies (Kafka, PostgreSQL, Redis, etc.) get auto-styled nodes
- Natural language editing: add, remove, or rewire any diagram; the spec is stored inside the
.excalidrawfile - Export to SVG and PNG without a browser or Node.js
- Optional living architecture knowledge graph that can be version-controlled and queried
Use cases
- Onboarding onto a new codebase: generate architecture and sequence diagrams without reading code
- Design docs and RFCs: create architecture sketches, state machines, quadrants, and Gantt charts in one visual language
- Runbooks and incident write-ups: sequence diagrams for events, timelines for timing, swimlanes for roles
- Data platform documentation: medallion tiers, role-scoped pipelines, integration topology
- Reporting without a BI tool: hand-drawn bar/line/scatter charts that match the architecture diagram style
- Documentation that stays alive: commit
.excalidrawfiles and revise them in natural language as the system changes
Getting started
bashpip install excalidraw-architect-mcpFor PNG export support:bashpip install excalidraw-architect-mcp[png]Or run without installing (requires uv):bashuvx excalidraw-architect-mcpConfigure MCP in your IDE by adding the command to your MCP configuration file (see repository README for Cursor, Claude Code, and Windsurf examples).
License and pricing
License: MIT. Pricing: open source.
Based on the project's public README and repository metadata.