Miro Automation

1---
2name: miro-automation
3description: "Automate Miro tasks via Rube MCP (Composio): boards, items, sticky notes, frames, sharing, connectors. Always search tools first for current schemas."
4requires:
5  mcp: [rube]
6---
7 
8# Miro Automation via Rube MCP
9 
10Automate Miro whiteboard operations through Composio's Miro toolkit via Rube MCP.
11 
12## Prerequisites
13 
14- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
15- Active Miro connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `miro`
16- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
17 
18## Setup
19 
20**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
21 
22 
231. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
242. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `miro`
253. If connection is not ACTIVE, follow the returned auth link to complete Miro OAuth
264. Confirm connection status shows ACTIVE before running any workflows
27 
28## Core Workflows
29 
30### 1. List and Browse Boards
31 
32**When to use**: User wants to find boards or get board details
33 
34**Tool sequence**:
351. `MIRO_GET_BOARDS2` - List all accessible boards [Required]
362. `MIRO_GET_BOARD` - Get detailed info for a specific board [Optional]
37 
38**Key parameters**:
39- `query`: Search term to filter boards by name
40- `sort`: Sort by 'default', 'last_modified', 'last_opened', 'last_created', 'alphabetically'
41- `limit`: Number of results per page (max 50)
42- `offset`: Pagination offset
43- `board_id`: Specific board ID for detailed retrieval
44 
45**Pitfalls**:
46- Pagination uses offset-based approach, not cursor-based
47- Maximum 50 boards per page; iterate with offset for full list
48- Board IDs are long alphanumeric strings; always resolve by search first
49 
50### 2. Create Boards and Items
51 
52**When to use**: User wants to create a new board or add items to an existing board
53 
54**Tool sequence**:
551. `MIRO_CREATE_BOARD` - Create a new empty board [Optional]
562. `MIRO_CREATE_STICKY_NOTE_ITEM` - Add sticky notes to a board [Optional]
573. `MIRO_CREATE_FRAME_ITEM2` - Add frames to organize content [Optional]
584. `MIRO_CREATE_ITEMS_IN_BULK` - Add multiple items at once [Optional]
59 
60**Key parameters**:
61- `name` / `description`: Board name and description (for CREATE_BOARD)
62- `board_id`: Target board ID (required for all item creation)
63- `data`: Content object with `content` field for sticky note text
64- `style`: Styling object with `fillColor` for sticky note color
65- `position`: Object with `x` and `y` coordinates
66- `geometry`: Object with `width` and `height`
67 
68**Pitfalls**:
69- `board_id` is required for ALL item operations; resolve via GET_BOARDS2 first
70- Sticky note colors use hex codes (e.g., '#FF0000') in the `fillColor` field
71- Position coordinates use the board's coordinate system (origin at center)
72- BULK create has a maximum items-per-request limit; check current schema
73- Frame items require `geometry` with both width and height
74 
75### 3. Browse and Manage Board Items
76 
77**When to use**: User wants to view, find, or organize items on a board
78 
79**Tool sequence**:
801. `MIRO_GET_BOARD_ITEMS` - List all items on a board [Required]
812. `MIRO_GET_CONNECTORS2` - List connections between items [Optional]
82 
83**Key parameters**:
84- `board_id`: Target board ID (required)
85- `type`: Filter by item type ('sticky_note', 'shape', 'text', 'frame', 'image', 'card')
86- `limit`: Number of items per page
87- `cursor`: Pagination cursor from previous response
88 
89**Pitfalls**:
90- Results are paginated; follow `cursor` until absent for complete item list
91- Item types must match Miro's predefined types exactly
92- Large boards may have thousands of items; use type filtering to narrow results
93- Connectors are separate from items; use GET_CONNECTORS2 for relationship data
94 
95### 4. Share and Collaborate on Boards
96 
97**When to use**: User wants to share a board with team members or manage access
98 
99**Tool sequence**:
1001. `MIRO_GET_BOARDS2` - Find the board to share [Prerequisite]
1012. `MIRO_SHARE_BOARD` - Share the board with users [Required]
1023. `MIRO_GET_BOARD_MEMBERS` - Verify current board members [Optional]
103 
104**Key parameters**:
105- `board_id`: Board to share (required)
106- `emails`: Array of email addresses to invite
107- `role`: Access level ('viewer', 'commenter', 'editor')
108- `message`: Optional invitation message
109 
110**Pitfalls**:
111- Email addresses must be valid; invalid emails cause the entire request to fail
112- Role must be one of the predefined values; case-sensitive
113- Sharing with users outside the organization may require admin approval
114- GET_BOARD_MEMBERS returns all members including the owner
115 
116### 5. Create Visual Connections
117 
118**When to use**: User wants to connect items on a board with lines or arrows
119 
120**Tool sequence**:
1211. `MIRO_GET_BOARD_ITEMS` - Find items to connect [Prerequisite]
1222. `MIRO_GET_CONNECTORS2` - View existing connections [Optional]
123 
124**Key parameters**:
125- `board_id`: Target board ID
126- `startItem`: Object with `id` of the source item
127- `endItem`: Object with `id` of the target item
128- `style`: Connector style (line type, color, arrows)
129 
130**Pitfalls**:
131- Both start and end items must exist on the same board
132- Item IDs are required for connections; resolve via GET_BOARD_ITEMS first
133- Connector styles vary; check available options in schema
134- Self-referencing connections (same start and end) are not allowed
135 
136## Common Patterns
137 
138### ID Resolution
139 
140**Board name -> Board ID**:
141```
1421. Call MIRO_GET_BOARDS2 with query=board_name
1432. Find board by name in results
1443. Extract id field
145```
146 
147**Item lookup on board**:
148```
1491. Call MIRO_GET_BOARD_ITEMS with board_id and optional type filter
1502. Find item by content or position
1513. Extract item id for further operations
152```
153 
154### Pagination
155 
156- Boards: Use `offset` and `limit` (offset-based)
157- Board items: Use `cursor` and `limit` (cursor-based)
158- Continue until no more results or cursor is absent
159- Default page sizes vary by endpoint
160 
161### Coordinate System
162 
163- Board origin (0,0) is at the center
164- Positive X is right, positive Y is down
165- Items positioned by their center point
166- Use `position: {x: 0, y: 0}` for center of board
167- Frames define bounded areas; items inside inherit frame position
168 
169## Known Pitfalls
170 
171**Board IDs**:
172- Board IDs are required for virtually all operations
173- Always resolve board names to IDs via GET_BOARDS2 first
174- Do not hardcode board IDs; they vary by account
175 
176**Item Creation**:
177- Each item type has different required fields
178- Sticky notes need `data.content` for text
179- Frames need `geometry.width` and `geometry.height`
180- Position defaults to (0,0) if not specified; items may overlap
181 
182**Rate Limits**:
183- Miro API has rate limits per token
184- Bulk operations preferred over individual item creation
185- Use MIRO_CREATE_ITEMS_IN_BULK for multiple items
186 
187**Response Parsing**:
188- Response data may be nested under `data` key
189- Item types determine which fields are present in response
190- Parse defensively; optional fields may be absent
191 
192## Quick Reference
193 
194| Task | Tool Slug | Key Params |
195|------|-----------|------------|
196| List boards | MIRO_GET_BOARDS2 | query, sort, limit, offset |
197| Get board details | MIRO_GET_BOARD | board_id |
198| Create board | MIRO_CREATE_BOARD | name, description |
199| Add sticky note | MIRO_CREATE_STICKY_NOTE_ITEM | board_id, data, style, position |
200| Add frame | MIRO_CREATE_FRAME_ITEM2 | board_id, data, geometry, position |
201| Bulk add items | MIRO_CREATE_ITEMS_IN_BULK | board_id, items |
202| Get board items | MIRO_GET_BOARD_ITEMS | board_id, type, cursor |
203| Share board | MIRO_SHARE_BOARD | board_id, emails, role |
204| Get members | MIRO_GET_BOARD_MEMBERS | board_id |
205| Get connectors | MIRO_GET_CONNECTORS2 | board_id |
206