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.