# Miro Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually - **Category:** team collaboration - **Auth:** OAUTH2 - **Composio Managed App Available?** Yes - **Tools:** 77 - **Triggers:** 0 - **Slug:** `MIRO` - **Version:** 20260417_00 ## Tools ### Attach Tag To Item **Slug:** `MIRO_ATTACH_TAG_TO_ITEM` Tool 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 can have up to 8 tags. ### Create App Card Item **Slug:** `MIRO_CREATE_APP_CARD_ITEM` Tool 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 response, not at the top level. Burst writes may trigger HTTP 429; honor the Retry-After header before retrying. ### Create Board **Slug:** `MIRO_CREATE_BOARD` Tool 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, returns HTTP 400; use MIRO_GET_BOARDS to reuse an existing board instead. ### Create Card Item **Slug:** `MIRO_CREATE_CARD_ITEM` Tool 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 Connector **Slug:** `MIRO_CREATE_CONNECTOR` Tool 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 flowcharts and diagrams. Both start and end items must be specified; connectors cannot be created with loose endpoints. ### Create Document Item **Slug:** `MIRO_CREATE_DOCUMENT_ITEM` Tool 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 Document Item Using File From Device **Slug:** `MIRO_CREATE_DOCUMENT_ITEM_USING_FILE_FROM_DEVICE` Tool to create a document item on a Miro board using a URL to the document. Use when you need to add a document (PDF, DOC, etc.) to a board from a publicly accessible URL. ### Create Embed Item **Slug:** `MIRO_CREATE_EMBED_ITEM` Tool 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 Item **Slug:** `MIRO_CREATE_FRAME_ITEM` Tool to add a frame item to a Miro board. Use frames to group and organize diagram regions (e.g., swimlanes, sections, slides). ### Create Frame (Deprecated) **Slug:** `MIRO_CREATE_FRAME_ITEM2` DEPRECATED: Use MIRO_CREATE_FRAME_ITEM instead. Tool to create a frame on a Miro board. Use when you need to group and organize content into sections or containers. ### Create Group **Slug:** `MIRO_CREATE_GROUP` Tool 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 Image Item Using Local File **Slug:** `MIRO_CREATE_IMAGE_ITEM_USING_LOCAL_FILE` Tool to create an image item on a Miro board by uploading a local image file. Use when you need to add an image from the user's device to a board, rather than referencing an external URL. ### Create Items in Bulk **Slug:** `MIRO_CREATE_ITEMS_IN_BULK` Tool 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 one API call. ### Create Mind Map Node (Experimental) **Slug:** `MIRO_CREATE_MINDMAP_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 Item (Deprecated) **Slug:** `MIRO_CREATE_SHAPE_ITEM` DEPRECATED: Use MIRO_MIRO_CREATE_SHAPE_ITEM2 instead. Tool to create a native Miro shape item (diagram node) on a board. Use when building diagrams, flowcharts, or architecture diagrams with shapes that can then be connected via MIRO_CREATE_CONNECTOR. ### Create Shape Item **Slug:** `MIRO_CREATE_SHAPE_ITEM2` Tool 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. ### Create Sticky Note Item **Slug:** `MIRO_CREATE_STICKY_NOTE_ITEM` Tool 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 Tag **Slug:** `MIRO_CREATE_TAG` Tool 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 Item **Slug:** `MIRO_CREATE_TEXT_ITEM` Tool 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 Item **Slug:** `MIRO_DELETE_APP_CARD_ITEM` Tool 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. ### Delete Card Item **Slug:** `MIRO_DELETE_CARD_ITEM` Tool 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 Connector **Slug:** `MIRO_DELETE_CONNECTOR` Tool 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 Item **Slug:** `MIRO_DELETE_DOCUMENT_ITEM` Tool 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 board 'board123'." ### Delete Embed Item **Slug:** `MIRO_DELETE_EMBED_ITEM` Tool 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 Frame Item **Slug:** `MIRO_DELETE_FRAME_ITEM` Tool 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 Group **Slug:** `MIRO_DELETE_GROUP` Tool to delete a group from a board. Use when you need to remove a group and optionally its items. ### Delete Image Item **Slug:** `MIRO_DELETE_IMAGE_ITEM` Tool to delete an image item from a board. Use when you need to remove an image that is no longer needed. ### Delete Item **Slug:** `MIRO_DELETE_ITEM` Tool 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) **Slug:** `MIRO_DELETE_MINDMAP_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 Shape Item **Slug:** `MIRO_DELETE_SHAPE_ITEM` Tool 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 Sticky Note Item **Slug:** `MIRO_DELETE_STICKY_NOTE_ITEM` Tool to delete a sticky note item from a board. Use when you need to remove a sticky note that is no longer needed. ### Delete Tag **Slug:** `MIRO_DELETE_TAG` Tool to delete a specific tag from a board. Use when you need to remove a tag after confirming its board and tag IDs. ### Delete Text Item **Slug:** `MIRO_DELETE_TEXT_ITEM` Tool to delete a text item from a board. Use when you need to remove a text item after confirming its board and item IDs. ### Get All Groups **Slug:** `MIRO_GET_ALL_GROUPS` Tool 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 2 **Slug:** `MIRO_GET_APP_CARD_ITEM2` Tool 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 (Deprecated) **Slug:** `MIRO_GET_BOARD` DEPRECATED: Use MIRO_GET_SPECIFIC_BOARD instead. Tool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata. ### Get Board Items **Slug:** `MIRO_GET_BOARD_ITEMS` Tool 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 stale item IDs. ### Get Board Members **Slug:** `MIRO_GET_BOARD_MEMBERS` Tool 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 or boards inaccessible to that user will not appear in the response. ### Get Boards (Deprecated) **Slug:** `MIRO_GET_BOARDS` DEPRECATED: Use MIRO_MIRO_GET_BOARDS2 instead. Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords. Only boards accessible to the authenticated user are returned. ### Get Boards V2 **Slug:** `MIRO_GET_BOARDS2` Tool 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 Card Item **Slug:** `MIRO_GET_CARD_ITEM` Tool 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 Connector **Slug:** `MIRO_GET_CONNECTOR` Tool to retrieve a specific connector by its ID. Use when you need details about an existing connector on a board. ### Get Connectors **Slug:** `MIRO_GET_CONNECTORS` Tool 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 Document Item **Slug:** `MIRO_GET_DOCUMENT_ITEM` Tool 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 Item **Slug:** `MIRO_GET_EMBED_ITEM` Tool to retrieve a specific embed item from a board by its ID. Use when you need details of an existing embedded content item. ### Get Frame Item **Slug:** `MIRO_GET_FRAME_ITEM` Tool 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 Group By ID **Slug:** `MIRO_GET_GROUP_BY_ID` Tool to retrieve a specific group by its ID. Use when you need to get details about a group on a Miro board. ### Get Image Item **Slug:** `MIRO_GET_IMAGE_ITEM` Tool to retrieve a specific image item from a board. Use when you need to get details about an existing image item. ### Get Item Tags **Slug:** `MIRO_GET_ITEM_TAGS` Tool 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 Node **Slug:** `MIRO_GET_MINDMAP_NODE_EXPERIMENTAL` Tool 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) **Slug:** `MIRO_GET_MINDMAP_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 Data **Slug:** `MIRO_GET_OEMBED` Tool 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 Item **Slug:** `MIRO_GET_SHAPE_ITEM` Tool 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 Board **Slug:** `MIRO_GET_SPECIFIC_BOARD` Tool 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 Member **Slug:** `MIRO_GET_SPECIFIC_BOARD_MEMBER` Tool 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 Item **Slug:** `MIRO_GET_SPECIFIC_ITEM` Tool 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 Item **Slug:** `MIRO_GET_STICKY_NOTE_ITEM` Tool 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 Tag **Slug:** `MIRO_GET_TAG` Tool 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 Text Item **Slug:** `MIRO_GET_TEXT_ITEM` Tool 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 Tags **Slug:** `MIRO_LIST_BOARD_TAGS` Tool to list all tags on a Miro board. Use when you need to discover tag IDs, titles, or colors before performing tag operations. ### Get Organization Context **Slug:** `MIRO_LIST_ORGANIZATIONS` Retrieves 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 endpoint to return the single organization context associated with the authenticated token, along with team and user information. For Enterprise users who need to work with organizations, use organization-specific endpoints like MIRO_GET_ORGANIZATION_MEMBERS which require an org_id parameter. ### Share Board **Slug:** `MIRO_SHARE_BOARD` Tool 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 roles (viewer, commenter, editor, coowner, or owner). ### Update App Card Item 2 **Slug:** `MIRO_UPDATE_APP_CARD_ITEM2` Tool 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 Board **Slug:** `MIRO_UPDATE_BOARD` Tool 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 Member **Slug:** `MIRO_UPDATE_BOARD_MEMBER` Tool 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 Item **Slug:** `MIRO_UPDATE_CARD_ITEM` Tool 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 Connector **Slug:** `MIRO_UPDATE_CONNECTOR` Tool 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 Item **Slug:** `MIRO_UPDATE_DOCUMENT_ITEM` Tool 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 Embed Item **Slug:** `MIRO_UPDATE_EMBED_ITEM` Tool 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 Frame Item **Slug:** `MIRO_UPDATE_FRAME_ITEM` Tool 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 Group **Slug:** `MIRO_UPDATE_GROUP` Tool 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 Item **Slug:** `MIRO_UPDATE_IMAGE_ITEM` Tool 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 Parent **Slug:** `MIRO_UPDATE_ITEM_POSITION_OR_PARENT` Tool 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 Item **Slug:** `MIRO_UPDATE_SHAPE_ITEM` Tool 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 change. ### Update Sticky Note Item **Slug:** `MIRO_UPDATE_STICKY_NOTE_ITEM` Tool 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 Tag **Slug:** `MIRO_UPDATE_TAG` Tool 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. ### Update Text Item **Slug:** `MIRO_UPDATE_TEXT_ITEM` Tool 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.