Excalidraw Architect MCP Server

Generate beautiful Excalidraw architecture diagrams with auto-layout and component styling

Local serverstdioPython

What is the Excalidraw Architect MCP server?

Connect Excalidraw Architect to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Generate beautiful Excalidraw architecture diagrams with auto-layout and component styling. The excalidraw architect mcp server is what makes that connection.

What the server does

It's been a constant struggle trying to understand unfamiliar and complex codebases - managing cognitive overload and trying to imagine how everything fits together.

  • One source of truth, many views — — store the whole system once, then render the full picture, a single domain, or everything within N hops of one service
  • Consistent across diagrams — — the same service keeps the same id, styling, and metadata everywhere
  • Queryable — — ask "what breaks if payments goes down?" and get the real blast radius, not a guess
  • Self-checking — — lint for dependency cycles, single points of failure, and orphaned services
  • Lives in git — — review architecture changes in PRs; the markdown diffs cleanly

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • create_diagram — Create a new diagram from structured node/connection data
  • mermaid_to_excalidraw — Convert Mermaid flowchart syntax to .excalidraw
  • modify_diagram — Add/remove/update nodes and connections on an existing diagram
  • 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

Installation

Installation goes through your MCP client rather than a global install: point it at excalidraw-architect-mcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Excalidraw Architect's toolset — create_diagram, mermaid_to_excalidraw, modify_diagram and 11 more — is a fair guide to whether it matches your workflow. It is maintained by BV-Venky; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Excalidraw Architect's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Excalidraw Architect.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
create_diagramCreate a new diagram from structured node/connection data
mermaid_to_excalidrawConvert Mermaid flowchart syntax to .excalidraw
modify_diagramAdd/remove/update nodes and connections on an existing diagram
get_diagram_infoRead current diagram state (call before modifying)
export_diagramExport .excalidraw to SVG or PNG image
kg_initCreate a new knowledge graph file
kg_set_domainGroup a service into a domain / bounded context
kg_infoSummarize services, domains, and topology
kg_renderRender the whole architecture to .excalidraw
kg_render_viewRender a focused diagram of specific services
kg_render_aroundRender everything within N hops of a service
kg_render_domainRender a single domain
kg_importBootstrap the graph from an existing .excalidraw diagram
whats_connected_toImpact analysis — upstream/downstream blast radius

How to install the Excalidraw Architect MCP server

{
  "mcpServers": {
    "excalidraw-architect": {
      "type": "stdio",
      "command": "excalidraw-architect-mcp"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Excalidraw Architect to create diagram.
  • Use Excalidraw Architect to mermaid to excalidraw.
  • Use Excalidraw Architect to modify diagram.

Frequently asked questions

It connects Excalidraw Architect to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (create_diagram, mermaid_to_excalidraw, modify_diagram, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Excalidraw Architect directly.