--- name: miro-boards description: Create and manage Miro board content including stickies, shapes, connectors, diagrams, and mindmaps. Use for whiteboard collaboration, sprint planning, retrospectives, and brainstorming. --- # Miro Board Management ## Trigger Working with Miro whiteboards: creating boards, adding content, building diagrams, or running collaborative workflows like sprint planning or retrospectives. ## Workflow 1. **Discover boards** — Call `miro_list_boards` or `miro_find_board` to get the target board ID. Every subsequent operation needs a board ID. 2. **Read existing content** — Use `miro_get_board` for an overview, `miro_list_items` or `miro_list_all_items` for specific content, or `miro_search_board` to find items by text. 3. **Create items** — Use the appropriate creation tool: - `miro_create_sticky` for sticky notes (colors: yellow, green, blue, pink, orange, red, gray, cyan, purple) - `miro_create_shape` for shapes (rectangle, circle, triangle, rhombus, star, hexagon) - `miro_create_text` for text labels - `miro_create_frame` for grouping sections - `miro_create_connector` to connect items (requires source and target item IDs) - `miro_create_card` for structured cards with descriptions - `miro_create_mindmap_node` for mindmap branches - `miro_bulk_create` when adding multiple items at once 4. **Connect items** — Save item IDs from creation responses. Use `miro_create_connector` with start and end item IDs. 5. **Organize** — Use `miro_create_frame` to group related items, `miro_create_group` to lock items together, or `miro_attach_tag` to categorize. ## Workflow Templates ### Sprint Board Create a frame for each column (Backlog, In Progress, Review, Done), then add stickies for tasks. ### Retrospective Create three sections with colored stickies: - Green: What went well - Pink: What could improve - Blue: Action items ### Brainstorming Create a central topic shape, then radiate stickies outward. Use connectors to show relationships. ### Mermaid Diagrams Use `miro_generate_diagram` to convert Mermaid syntax into visual diagrams on the board. Supports flowcharts and sequence diagrams. ## Guardrails - Always start with `miro_list_boards` to get board IDs; never guess or hardcode them. - Save returned item IDs for subsequent connection and update operations. - Use `miro_bulk_create` for 3+ items instead of individual create calls. - Keep confirmations short: "Added 3 stickies to Sprint Board" not lengthy descriptions. - When updating items, read the current state first with `miro_get_item`.