Miro for AI agents
Agents read Miro at once. Changes and sends are held for a person's approval by default.
About Miro
Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually
What an agent can do in Miro
Every Miro action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Miro without asking first. 29 actions.
- Get Board MembersTool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID. Results are scoped to the authenticated user's permissions; members
- Get Boards V2Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords with full pagination support.
- Get Frame ItemTool to retrieve a specific frame item from a Miro board. Use when you need to fetch details of an existing frame by its ID.
- Get TagTool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.
- Get Organization ContextRetrieves the organization associated with the current access token. Note: Miro's API does not have an endpoint to list all organizations a user has access to. This action uses the /v1/oauth-token end
- Get All GroupsTool to retrieve all groups on a Miro board with cursor-based pagination. Use when you need to list all groups and their associated items on a board.
- Get App Card Item 2Tool to retrieve a specific app card item by its ID from a Miro board. Use when you need to get the details of an existing app card item.
- Get Board ItemsTool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting. Re-fetch before bulk updates to avoid s
- Get Card ItemTool to retrieve a specific card item from a Miro board. Use when you need to fetch details of an existing card item by its ID.
- Get ConnectorTool to retrieve a specific connector by its ID. Use when you need details about an existing connector on a board.
- Get ConnectorsTool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.
- Get Doc Format ItemRetrieve a structured Miro doc as Markdown or HTML.
Show all 29
- Get Document ItemTool to retrieve a specific document item from a Miro board by its ID. Use when you need to get details about an existing document item.
- Get Embed ItemTool to retrieve a specific embed item from a board by its ID. Use when you need details of an existing embedded content item.
- Get Group By IDTool to retrieve a specific group by its ID. Use when you need to get details about a group on a Miro board.
- Get Image ItemTool to retrieve a specific image item from a board. Use when you need to get details about an existing image item.
- Get Items by Group IDTool to retrieve items of a specific group by its ID on a Miro board. Use when you need to fetch all items belonging to a particular group.
- Get Items Within FrameGet items within a specific frame on a Miro board. Retrieves child items contained within a frame by filtering with parent_item_id parameter. Use this action when you need to list all items (shapes, s
- Get Item TagsTool to retrieve tags attached to a specific item on a Miro board. Use when you need to get the tags associated with a particular item.
- Get Mind Map NodeTool to retrieve a specific mind map node from a board. Use when you need to get details about a mind map node by its ID.
- Get Mind Map Nodes (Experimental)Tool to retrieve mind map nodes from a Miro board. Use when you need to access the structure and content of mind maps on a board.
- Get oEmbed DataTool to retrieve oEmbed data for a Miro board. Use when you need to generate embeddable HTML code for a board or get board metadata in oEmbed format.
- Get Shape ItemTool to retrieve a specific shape item from a Miro board by its ID. Use when you need to get details of an existing shape item.
- Get Specific BoardTool to retrieve detailed information about a specific board by its ID. Use when you need to fetch complete metadata including team, permissions, owner, and modification details for a board.
- Get Specific Board MemberTool to retrieve details of a specific board member. Use when you have a board ID and board member ID and need to get that member's role and information.
- Get Specific ItemTool to retrieve a specific item from a Miro board by its ID. Use when you need details about a particular board item (sticky note, shape, card, frame, etc.).
- Get Sticky Note ItemTool to retrieve a specific sticky note item from a board by its ID. Use when you need to get the details of an existing sticky note item.
- Get Text ItemTool to retrieve a specific text item from a Miro board by its ID. Use when you need to get the details of an existing text item.
- List Board TagsTool to list all tags on a Miro board. Use when you need to discover tag IDs, titles, or colors before performing tag operations.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 48 actions.
- Attach Tag To ItemTool to attach an existing tag to a specific item on a Miro board. Use when you need to associate a tag with an item after confirming the board, item, and tag IDs. Note that card and sticky note items
- Create BoardTool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan". If workspace board quota is reached,
- Create Card ItemTool to create a card item on a Miro board. Use when you need to add task cards with titles, descriptions, due dates, and assignees.
- Create ConnectorTool to create a connector (edge/arrow) that links two existing board items. Use after creating or locating the two endpoint items (shapes/cards/stickies) to establish visual relationships in flowchar
- Create Doc Format ItemCreate a structured Markdown doc on a Miro board.
- Create Document ItemTool to create a document item on a Miro board by providing a URL to the document. Use when you need to attach a document (PDF, DOC, etc.) to a board from a publicly accessible URL.
- Create Image Item from URLCreates an image item on a Miro board by providing a URL to a publicly accessible image. This action adds images from external URLs rather than uploading files from local storage. Use this action when
- Create Items in BulkTool to create multiple items on a Miro board in a single request. Use when you need to add 1-20 items (text, sticky notes, shapes, cards, frames, etc.) efficiently. Items are created atomically in on
- Create Sticky Note ItemTool to create a sticky note item on a Miro board. Use when you need to add a new sticky note with customizable content, color, shape, and position.
- Create TagTool to create a new tag on a Miro board. Use when you need to add a new tag with a specific title and color to categorize board items.
- Create Text ItemTool to create a text item on a Miro board. Use when you need to add text content to a board, such as labels, notes, or annotations.
- Delete App Card ItemTool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed.
Show all 48
- Delete Frame ItemTool to delete a frame item from a Miro board. Use when you need to remove a frame that groups or organizes content on the board.
- Delete Shape ItemTool to delete a shape item from a board. Use when you need to remove a specific shape that is no longer needed after confirming its board and item IDs.
- Delete Text ItemTool to delete a text item from a board. Use when you need to remove a text item after confirming its board and item IDs.
- Remove Tag From ItemTool to remove a tag from a specific item on a Miro board. Use when you need to disassociate a tag from an item after confirming the board, item, and tag IDs. This action removes the tag from only thi
- Update Embed ItemTool to update an embed item on a board. Use when you need to modify properties of an existing embedded content item such as position, display mode, or URL.
- Update TagTool to update a tag on a board. Use when you need to modify a tag's title or color. At least one field (title or fillColor) should be provided to update.
- Create App Card ItemTool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board. Returns the created card; the card ID is nested under data.id in the respon
- Create Embed ItemTool to create an embed item on a Miro board by providing a URL to embed content (YouTube videos, websites, etc.). Use when you need to add embedded content from external sources to a board.
- Create Frame ItemTool to add a frame item to a Miro board. Use frames to group and organize diagram regions (e.g., swimlanes, sections, slides).
- Create GroupTool to create a group on a Miro board by grouping multiple items together. Use when you need to organize related board items (shapes, sticky notes, cards, etc.) into a single logical group.
- Create Mind Map Node (Experimental)Tool to create a mind map node on a Miro board. Use when building mind maps or organizing ideas visually in a hierarchical structure. This is an experimental endpoint.
- Create Shape ItemTool to create a shape item on a Miro board. Use when you need to add shapes (basic or flowchart) to a board with specific styling and positioning.
- Delete Card ItemTool to delete a card item from a board. Use when you need to remove a card item from a Miro board after it is no longer needed.
- Delete ConnectorTool to delete a specific connector from a board. Use when you need to remove a connector (edge/arrow) between board items after confirming its board and connector IDs.
- Delete Document ItemTool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from boar
- Delete Embed ItemTool to delete an embed item from a board. Use when you need to remove an embedded content item (e.g., YouTube video, website) that is no longer needed.
- Delete GroupTool to delete a group from a board. Use when you need to remove a group and optionally its items.
- Delete Image ItemTool to delete an image item from a board. Use when you need to remove an image that is no longer needed.
- Delete ItemTool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs.
- Delete Mind Map Node (Experimental)Tool to delete a mind map node from a board. Use when you need to remove a mind map node after confirming its board and item IDs. This is an experimental endpoint.
- Delete Sticky Note ItemTool to delete a sticky note item from a board. Use when you need to remove a sticky note that is no longer needed.
- Delete TagTool to delete a specific tag from a board. Use when you need to remove a tag after confirming its board and tag IDs.
- Share BoardTool to share a board by inviting users via email. Use when you need to grant access to a board by sending email invitations to new members. You can invite up to 20 users per call and assign them role
- Update App Card Item 2Tool to update an app card item on a Miro board. Use when you need to modify properties of an existing app card such as title, description, status, style, position, or geometry.
- Update BoardTool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists.
- Update Board MemberTool to update the role of a specific board member. Use when you have a board ID and board member ID and need to change that member's permissions or role on the board.
- Update Card ItemTool to update a card item on a Miro board. Use when you need to modify properties of an existing card item such as title, description, due date, assignee, style, position, or geometry.
- Update ConnectorTool to update an existing connector on a Miro board. Use when you need to modify connector properties such as shape, style, captions, or endpoint attachments. Only provided fields will be updated.
- Update Document ItemTool to update a document item on a Miro board. Use when you need to modify properties of an existing document item such as URL, title, position, or geometry.
- Update Frame ItemTool to update a frame item on a Miro board. Use when you need to modify properties of an existing frame such as title, position, size, or styling. Include only fields to change.
- Update GroupTool to update a group on a Miro board with new items. Use when you need to change which items belong to an existing group.
- Update Image ItemTool to update an existing image item on a board. Use when you need to modify properties of an existing image item such as title, URL, position, or geometry.
- Update Item Position or ParentTool to update an item's position or parent frame on a Miro board. Use when you need to move an item to a new location or assign it to a different parent frame.
- Update Shape ItemTool to update an existing shape item on a Miro board. Use when you need to modify properties of a shape such as content, style, position, geometry, or parent. Include only the fields you want to chan
- Update Sticky Note ItemTool to update a sticky note item on a Miro board. Use when you need to modify the content, style, position, geometry, or parent of an existing sticky note.
- Update Text ItemTool to update a text item on a Miro board. Use when you need to modify the content, style, position, or other properties of an existing text item.
Changes wait in Needs you
Changes and sends in Miro are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Miro questions
Can an agent change data in Miro on its own?
Not by default. Changes and sends in Miro are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Miro?
This connector lists 29 read actions. Reads run at once, without waiting for approval.
How does Miro connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.