Create a flowchart diagram with Sugiyama hierarchical auto-layout.

Generates a hand-drawn style Excalidraw flowchart from nodes and edges. Handles branches, merges, cycles, and disconnected subgraphs. Supports Chinese/CJK text with accurate width estimation.

Args: nodes: List of nodes with label and optional color edges: List of edges connecting nodes (by label or 0-based index) direction: Layout direction - "LR" (left to right), "RL", "TB" (top to bottom), "BT" title: Optional diagram title output_path: Optional output file path (default: /tmp/flowchart.excalidraw) theme: Color theme - "light" (default) or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a layered architecture diagram.

Args: layers: List of layers, each with 'name' and 'components' list. Example: [{"name": "Frontend", "color": "blue", "components": [{"label": "React App"}, {"label": "Next.js"}]}] connections: List of connections between components. Example: [{"from": "React App", "to": "API Server"}] output_path: Optional output file path

Returns: Path to the generated .excalidraw file

Create a UML-style sequence diagram.

Generates a hand-drawn style sequence diagram with participants, lifelines, and messages. Supports solid arrows for requests and dashed arrows for responses.

Args: participants: List of participant names (ordered left to right) messages: List of messages with from, to, label, and optional style title: Optional diagram title output_path: Optional output file path (default: /tmp/sequence.excalidraw)

Returns: Absolute path to the generated .excalidraw file

Import a Mermaid flowchart and convert to Excalidraw.

Parses Mermaid flowchart syntax and generates a hand-drawn Excalidraw diagram with Sugiyama layout.

Args: mermaid: Mermaid flowchart text output_path: Optional output file path

Returns: Absolute path to the generated .excalidraw file

Import any Mermaid diagram and convert to Excalidraw.

Auto-detects diagram type (flowchart or sequence diagram) and generates the appropriate Excalidraw diagram.

Args: mermaid: Mermaid diagram text (flowchart or sequenceDiagram) output_path: Optional output file path

Returns: Absolute path to the generated .excalidraw file

Create a mind map diagram from a tree structure.

Generates a tree-style mind map with the root node in the center-left and branches spreading to the right. Each top-level branch gets a distinct color.

Args: root: Root node with label and optional children (nested tree) title: Optional diagram title output_path: Optional output file path (default: /tmp/mindmap.excalidraw)

Returns: Absolute path to the generated .excalidraw file

Create an Entity-Relationship (ER) diagram.

Generates a database-style ER diagram with entity boxes showing attributes and relationship arrows with cardinality labels.

Args: entities: List of entities with name and attributes relationships: List of relationships between entities title: Optional diagram title output_path: Optional output file path

Returns: Absolute path to the generated .excalidraw file

Create a timeline / Gantt chart diagram.

Generates a horizontal bar chart showing events/tasks over time. Overlapping events are automatically placed on separate rows.

Args: events: List of events with label, start, end, and optional color title: Optional diagram title output_path: Optional output file path (default: /tmp/timeline.excalidraw) theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a UML class diagram.

Generates a class diagram with class boxes showing attributes and methods, connected by relationship arrows (inheritance, composition, etc.).

Args: classes: List of class definitions with name, attributes, and methods relationships: List of relationships between classes title: Optional diagram title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a UML state machine diagram.

Generates a state diagram with states (rounded rectangles), initial states (filled circles), final states (double border), and transition arrows with labels.

Args: states: List of state definitions transitions: List of transitions between states title: Optional diagram title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a pie chart diagram.

Generates a pie chart with labeled slices showing proportions. Each slice displays its label and percentage.

Args: slices: List of slices with label and value title: Optional chart title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a Kanban board diagram.

Generates a column-based task board with cards in each column. Great for visualizing workflows, sprints, and task status.

Args: columns: List of columns with name and card labels title: Optional board title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a network topology diagram.

Generates a network diagram with typed nodes (server, database, loadbalancer, etc.) and connections. Different node types get distinct shapes and colors.

Args: nodes: List of network nodes with type links: List of connections between nodes title: Optional diagram title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a quadrant (2x2 matrix) chart.

Generates a four-quadrant chart for positioning items along two axes. Great for priority matrices, effort/impact charts, and positioning maps.

Args: items: List of items with label and x/y position (0-1 range) x_label: X axis label (e.g., "Effort") y_label: Y axis label (e.g., "Impact") quadrant_labels: Optional 4 labels [top-right, top-left, bottom-right, bottom-left] title: Optional chart title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a user journey map.

Generates a horizontal journey map showing steps with emotion indicators. Each step shows a label, emotion (color-coded), and optional description.

Args: steps: List of journey steps with label and emotion title: Optional journey title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Absolute path to the generated .excalidraw file

Create a wireframe UI mockup.

Generates a simple wireframe with common UI components stacked vertically. Great for quick screen mockups and UI planning.

Component types:

• header: Full-width header bar

• text: Plain text block

• button: Centered button

• input: Text input field

• image: Image placeholder

• card: Content card

• nav: Navigation bar

• divider: Horizontal line

Args: components: List of UI components in order device: Device frame: "phone", "tablet", "desktop", "none" title: Optional wireframe title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create an organizational chart.

Generates a top-down hierarchical org chart from a tree structure. Each node can have a title/description and subordinates.

Args: root: Root node with label and optional children title: Optional chart title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create a SWOT analysis diagram.

Generates a color-coded 2x2 SWOT matrix with bullet-pointed items in each quadrant (Strengths, Weaknesses, Opportunities, Threats).

Args: strengths: List of strength items weaknesses: List of weakness items opportunities: List of opportunity items threats: List of threat items title: Optional diagram title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Modify an existing .excalidraw diagram.

Args: file_path: Path to existing .excalidraw file add_nodes: Nodes to add: [{"label": "New Node", "color": "green", "x": 100, "y": 100}] remove_labels: Labels of nodes to remove add_connections: New connections: [{"from": "Node A", "to": "Node B"}] output_path: Optional output path (default: overwrite input file)

Returns: Path to the modified file

Export an .excalidraw file to SVG format.

Args: file_path: Path to the .excalidraw file format: Export format - currently "svg" supported

Returns: Path to the exported file

Read and analyze an existing .excalidraw file.

Returns a structured description of the diagram including:

• List of shapes with labels and positions

• List of connections between shapes

• Color scheme used

Args: file_path: Path to the .excalidraw file

Returns: Human-readable description of the diagram structure

Create a table diagram.

Generates a grid-based table with header row and data rows. Auto-sizes columns based on content. Great for comparison tables, feature matrices, and data displays.

Args: headers: Column header labels rows: List of rows, each row is a list of cell values title: Optional table title header_color: Header row color name output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create a radar/spider chart.

Generates a radar chart with axes radiating from center. Supports single or multiple data series overlay.

Args: axes: List of axis names (minimum 3) values: Single set of values (0-1), one per axis series: Multiple series for comparison title: Optional chart title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create a vertical bar chart.

Generates a bar chart with auto-scaled bars, value labels, and axis labels.

Args: bars: List of bars with label and value title: Optional chart title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create a line chart with one or more data series.

Generates a line chart with auto-scaled Y axis, X-axis labels, and color-coded series.

Args: series: List of data series with label and points x_labels: Labels for the X axis title: Optional chart title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

Create a decision tree diagram.

Generates a tree with diamond-shaped decision nodes and rectangular outcome nodes, connected by labeled edges.

Args: nodes: List of nodes with id, label, and type edges: List of edges with from, to, and optional label title: Optional diagram title output_path: Optional output file path theme: Color theme

Returns: Absolute path to the generated .excalidraw file

List all available diagram types and tools.

Returns a formatted list of all diagram types this MCP server can generate, with tool names and descriptions.

Returns: Formatted list of available diagram types

Create any type of diagram with a single unified tool.

This is a convenience tool that routes to the specific diagram tool based on the diagram_type parameter. Use list_diagram_types to see all available types.

Args: diagram_type: Type of diagram (flowchart, sequence, mindmap, er, class, state, timeline, pie, kanban, network, quadrant, journey, wireframe, org, swot, architecture) data: Diagram-specific data (varies by type) title: Optional diagram title output_path: Optional output file path theme: Color theme - "light" or "dark"

Returns: Path to generated file or error message