# Excalidraw Architect (MCP server)

> Excalidraw Architect is an MCP server that generates beautiful Excalidraw architecture diagrams with auto-layout and component styling. It has 157 GitHub stars, is released under the MIT license and runs locally with uvx excalidraw-architect-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.

Every diagram your engineering docs need — as hand-drawn Excalidraw, generated by your AI. Twenty-five diagram types. Architecture and flowcharts, but also sequence diagrams, state machines, ER models, swimlanes, timelines, Gantt charts, quadrants, funnels, and hand-sketched bar/line/scatter charts. No coordinates to hallucinate, no Figma, no stale PNGs.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/BV-Venky/excalidraw-architect-mcp |
| GitHub stars | 157 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: excalidraw-architect-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Developer tools |
| Latest release | v2.0.0 (Aug 25, 2026) |
| Last commit | Aug 25, 2026 |
| MCP registry name | io.github.BV-Venky/excalidraw-architect-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "excalidraw-architect": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio excalidraw-architect -- uvx excalidraw-architect-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "excalidraw-architect": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "excalidraw-architect": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `create_diagram`: Create a diagram of any of the 25 supported types
- `list_diagram_types`: Every type with when-to-use / when-not-to guidance
- `get_diagram_schema`: Spec schema + worked example for one type
- `mermaid_to_excalidraw`: Convert Mermaid flowchart syntax to .excalidraw
- `modify_diagram`: Patch an existing diagram — nodes/connections, or the stored spec
- `get_diagram_info`: Read current diagram state (call before modifying)
- `export_diagram`: Export .excalidraw to SVG or PNG image
- `kg_init`: Create a new knowledge graph file
- `kg_set_domain`: Group a service into a domain / bounded context
- `kg_info`: Summarize services, domains, and topology
- `kg_render`: Render the whole architecture to .excalidraw
- `kg_render_view`: Render a focused diagram of specific services
- `kg_render_around`: Render everything within N hops of a service
- `kg_render_domain`: Render a single domain
- `kg_import`: Bootstrap the graph from an existing .excalidraw diagram
- `whats_connected_to`: Impact analysis — upstream/downstream blast radius
- `kg_path`: Trace the dependency path between two services
- `kg_lint`: Health check: cycles, single points of failure, orphans, dangling refs
- `kg_export`: Export the graph to Mermaid, Graphviz DOT, or JSON
- `kg_diff`: Show how the architecture changed since a git ref
- `kg_onboarding_doc`: Generate a human onboarding guide from the graph
- `kg_drift`: Detect drift between the declared graph and Python imports

## Similar MCP servers

- [Gemini CLI](https://appsgit.com/mcp-servers/gemini-cli): An open-source AI agent that brings the power of Gemini directly into your terminal. (107,240 stars, Apache-2.0)
- [Front-End Checklist](https://appsgit.com/mcp-servers/front-end-checklist): Review frontend code and live pages against 386 quality-gated web development rules. (74,390 stars, MIT)
- [Claude Flow](https://appsgit.com/mcp-servers/claude-flow): AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev. (74,016 stars, MIT, needs API key)
- [Codebase Memory](https://appsgit.com/mcp-servers/codebase-memory): Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens. (45,917 stars, MIT)
- [Bytedance Filesystem](https://appsgit.com/mcp-servers/bytedance-filesystem): MCP server for filesystem access. (39,206 stars, Apache-2.0)
- [GitHub](https://appsgit.com/mcp-servers/github): Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language. (33,414 stars, MIT, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/excalidraw-architect
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.