name: canvas description: Use when the user asks to draw diagrams, create flowcharts, sketch architecture, visualize concepts, make a canvas, open Excalidraw, or mentions visual collaboration. Provides AI-powered visual collaboration using Excalidraw. version: 1.0.0 allowed-tools: [mcp__plugin_collaborative-canvas_canvas__open_canvas, mcp__plugin_collaborative-canvas_canvas__close_canvas, mcp__plugin_collaborative-canvas_canvas__list_canvases, mcp__plugin_collaborative-canvas_canvas__save_canvas, mcp__plugin_collaborative-canvas_canvas__get_canvas_state, mcp__plugin_collaborative-canvas_canvas__update_canvas, mcp__plugin_collaborative-canvas_canvas__export_canvas, mcp__plugin_collaborative-canvas_canvas__delete_canvases, mcp__plugin_collaborative-canvas_canvas__listen, mcp__plugin_collaborative-canvas_canvas__add_to_canvas, mcp__plugin_collaborative-canvas_canvas__close_widget, mcp__plugin_collaborative-canvas_canvas__capture_screenshot]

Canvas - Visual Collaboration

Overview

Canvas provides AI-powered visual collaboration using Excalidraw. Create diagrams, flowcharts, system architectures, and visual documentation with Claude's assistance.

When to Use

• Create diagrams or flowcharts
• Sketch system architecture
• Visualize concepts or ideas
• Make technical drawings
• Visual collaboration on designs

Workflow

1. Open canvas: open_canvas({ name: "My Diagram" })
2. Wait for user: listen({ drawingId: "..." })
3. User draws in the Excalidraw window
4. User clicks Collaborate for feedback
5. Review: get_canvas_state({ drawingId: "..." })
6. Add elements: save_canvas({ drawingId: "...", elements: [...] })
7. Repeat until user clicks Finish
8. Close: close_widget({ drawingId: "..." })

Key Tools

| Tool | Purpose | |------|---------| | open_canvas | Create or open a drawing | | listen | Wait for user collaboration | | save_canvas | Save elements to canvas | | get_canvas_state | View current drawing state | | add_to_canvas | Add elements programmatically | | close_widget | Close the Excalidraw window | | list_canvases | List all saved drawings | | capture_screenshot | Capture canvas as image |

Best Practices

1. Always call listen after opening or saving a canvas to wait for user input
2. Use compact element format for large diagrams to stay within token limits
3. Respond visually - add annotations and elements when collaborating
4. Close properly - call close_widget when finished to clean up

Element Format

When adding elements, use compact format:

{
  "elements": [
    { "type": "rectangle", "x": 100, "y": 100, "width": 200, "height": 100 },
    { "type": "text", "x": 150, "y": 130, "text": "Hello" },
    { "type": "arrow", "x": 300, "y": 150, "points": [[0, 0], [100, 50]] }
  ]
}

IDs are auto-generated if not provided.

Storage Location

Drawings are saved to ~/.local/share/collaborative-canvas/drawings/ with metadata.