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 .excalidraw file
  • 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 .excalidraw files 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/bv-venkyexcalidraw-architect-mcp.svg)](https://yunodb.com/tools/bv-venkyexcalidraw-architect-mcp?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/bv-venkyexcalidraw-architect-mcp?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/bv-venkyexcalidraw-architect-mcp.svg" alt="Featured on YunoDB" height="20"></a>