excalidraw-architect-mcp

Create a new Excalidraw diagram from structured node and connection data.

The LLM provides a relationship map - this tool handles layout, styling, and rendering. No need to specify coordinates.

Args: nodes: List of nodes. Each dict has: - id (str, required): Unique identifier - label (str, required): Display text - component_type (str, optional): Technology name for auto-styling (e.g., "kafka", "postgresql", "redis", "nginx", "kubernetes"). If omitted, the label is used for auto-detection. - shape (str, optional): Override shape - "rectangle", "diamond", "ellipse", "circle", "stadium", "parallelogram" connections: List of connections. Each dict has: - from_id (str, required): Source node id - to_id (str, required): Target node id - label (str, optional): Edge label text - style (str, optional): "solid", "dashed", "dotted", "thick" output_path: File path to save the .excalidraw file (e.g., "./arch.excalidraw") direction: Layout direction - "LR" (left-right), "TD" (top-down), "BT" (bottom-up), "RL" (right-left). Default: "LR" theme: Color theme - "default", "dark", "colorful". Default: "default"

Returns: Summary of the created diagram with file path.

Convert Mermaid flowchart syntax into an Excalidraw diagram.

Supports the mermaid flowchart subset that AI agents commonly generate:

• Directions: graph TD, LR, BT, RL

• Node shapes: [text], {text}, ((text)), ([text])

• Edge types: -->, ---, -.-> ==> with |label|

• Subgraphs: subgraph Title ... end

Component types are auto-detected from node labels (e.g., a node labeled "PostgreSQL DB" automatically gets database styling).

Args: mermaid_syntax: Mermaid flowchart source code. output_path: File path to save the .excalidraw file. theme: Color theme - "default", "dark", "colorful". Default: "default"

Returns: Summary of the converted diagram.

Modify an existing Excalidraw diagram created by this tool.

Supports iterative editing: add components, remove nodes, update labels, and rewire connections - without recreating the entire diagram.

IMPORTANT: Call get_diagram_info first to understand the current diagram state before making modifications.

Args: file_path: Path to the existing .excalidraw file. operations: Ordered list of operations. Each dict has: - op: "add_node" | "remove_node" | "update_node" | "add_connection" | "remove_connection"

    For add_node:
      - id (str): New node identifier
      - label (str): Display text
      - component_type (str, optional): Technology for auto-styling
      - shape (str, optional): Shape override
      - near (str, optional): Place near this existing node id

    For remove_node:
      - id (str): Node to remove (also removes its connections)

    For update_node:
      - id (str): Node to update
      - label (str, optional): New label
      - component_type (str, optional): New component type

    For add_connection:
      - from_id (str): Source node id
      - to_id (str): Target node id
      - label (str, optional): Edge label

    For remove_connection:
      - from_id (str): Source node id
      - to_id (str): Target node id

theme: Color theme for re-rendering. Default: "default"

Returns: Summary of applied modifications.

Get a structured summary of an existing Excalidraw diagram.

Call this BEFORE modify_diagram to understand what nodes and connections currently exist. The summary includes node ids, labels, component types, and the full connection topology.

Args: file_path: Path to the .excalidraw file.

Returns: Human-readable summary of all nodes and connections.