Log inSubmit server
Excalidraw Architect MCP logo

Excalidraw Architect MCP

by BV-Venky

Generates and edits Excalidraw architecture diagrams with automatic layout, technology-aware styling, exports, and a persistent knowledge graph.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Excalidraw Architect MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bv-venky-excalidraw-architect-mcp": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 26 tools correctly (1mo ago).

Overview

BV-Venky/excalidraw-architect-mcp MCP server turns structured architecture data or Mermaid flowcharts into editable Excalidraw diagrams. It calculates layout, applies component styles for recognized technologies, supports iterative edits, and exports diagrams to SVG or PNG without a browser. An optional markdown knowledge graph stores services and dependencies for rendering, impact analysis, linting, drift checks, and version comparisons. Reach for it when diagrams need to be generated and maintained from architectural data rather than positioned manually.

Use cases

  • Generate architecture diagrams from service and dependency relationships
  • Convert Mermaid flowcharts into editable Excalidraw files
  • Revise existing diagrams by adding, removing, or rewiring components
  • Track services and dependencies in a version-controlled knowledge graph
  • Check architecture impact, drift, cycles, and dependency paths

Key features

  • Automatic diagram layout
  • Technology-aware component styling
  • Mermaid flowchart conversion
  • Iterative Excalidraw editing
  • SVG and PNG export
  • Architecture knowledge graph analysis

Tools26

What Excalidraw Architect MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/19 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · excalidraw-architect-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars161Stargazers on the source repository.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed26Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Excalidraw Architect MCP works

What BV-Venky/excalidraw-architect-mcp MCP server does

BV-Venky/excalidraw-architect-mcp MCP server creates Excalidraw files from structured nodes and connections, or from a supported subset of Mermaid flowchart syntax. The server owns positioning and visual treatment, so callers provide relationships and labels instead of drawing coordinates. Labels can trigger architecture-aware styling; for example, a node mentioning PostgreSQL can receive database styling.

The project supports a broad set of diagram forms, including architecture diagrams, flowcharts, sequence diagrams, state machines, entity-relationship models, swimlanes, timelines, Gantt charts, quadrants, funnels, trees, organizational charts, and several chart types. It can also export an existing diagram as SVG or PNG without requiring the Excalidraw application or a browser.

How it works

For direct diagram creation, an agent sends component and connection data to create_diagram. The layout engine determines placement and renders a real .excalidraw file. mermaid_to_excalidraw accepts directions such as top-down, left-to-right, bottom-to-top, and right-to-left, along with several node shapes, edge styles, labels, and subgraphs.

Existing diagrams can be changed incrementally. The recommended sequence is to call get_diagram_info, inspect the returned node IDs, labels, types, and connections, and then call modify_diagram. This supports adding components, deleting nodes, changing labels, and rewiring relationships without rebuilding the complete file.

The optional knowledge graph uses a markdown file as its persistent architecture model. Services, domains, and directed dependencies can be added, removed, linked, queried, rendered, and exported. Focused views can show a selected service neighborhood, a domain, or an induced subgraph. The graph also supports dependency paths, failure-impact analysis, architecture linting, Git-based diffs, onboarding documentation, and best-effort comparison with Python imports.

Tools and capabilities

The MCP tool set includes:

  • Create diagrams from structured node and connection data.
  • Convert supported Mermaid flowcharts into Excalidraw files.
  • Inspect and modify diagrams iteratively.
  • Export diagrams to SVG and PNG.
  • Initialize and maintain a markdown architecture knowledge graph.
  • Render complete, domain-specific, or service-focused graph views.
  • Analyze dependency paths, upstream impact, cycles, orphans, and single points of failure.
  • Compare the graph with a Git reference or Python import structure.
  • Generate an onboarding guide from the recorded architecture.

Limitations and notes

Mermaid conversion is limited to the documented flowchart subset: four graph directions, four node-shape forms, the listed arrow styles and labels, and subgraph ... end blocks. Knowledge-graph drift analysis is best effort: it treats top-level Python packages as services and infers relationships from imports, so its findings may require review.

The project is described as running offline and requiring no API keys. Before changing a diagram or mutating the knowledge graph, inspect its current state with get_diagram_info or kg_info respectively. BV-Venky/excalidraw-architect-mcp MCP server is therefore most suitable when the source structure can be represented as nodes, edges, services, domains, or supported diagram data.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Excalidraw Architect MCP

Call `create_diagram` with structured node and connection data. The server determines the layout, styling, and rendering, so coordinates are not required.

Yes. `mermaid_to_excalidraw` supports the documented flowchart subset, including four directions, several node shapes, edge styles, labels, and subgraphs.

Call `get_diagram_info` first, then use `modify_diagram` to add components, remove nodes, update labels, or rewire connections.

No. The supplied project description states that it runs offline and does not require API keys.

Use `export_diagram` to convert an existing `.excalidraw` file into an SVG or PNG image without a browser or the Excalidraw application.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewExcalidraw Architect MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bv-venky-excalidraw-architect-mcp?style=directory)](https://allmcps.com/mcp/bv-venky-excalidraw-architect-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/bv-venky-excalidraw-architect-mcp"><img src="https://allmcps.com/api/badge/bv-venky-excalidraw-architect-mcp?style=directory" alt="Excalidraw Architect MCP on AllMCPs" /></a>