miro-boards

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.