Dev & Project Management
🧠 Miro integration
Access levels: Read-only · Read + write · Full access · Verified
Dev & Project Management
Access levels: Read-only · Read + write · Full access · Verified
Connect Miro once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | Read board content. | |
| Read + write | Read and edit boards. | Recommended |
| Full access | Also manage team members and identity. |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 77 tools agents use in Miro through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Attach tag to itemMIRO_ATTACH_TAG_TO_ITEM | Attach an existing tag to a specific item on a Miro board. | Read + write, Full access |
Create app card itemMIRO_CREATE_APP_CARD_ITEM | 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. B… | Read + write, Full access |
Create boardMIRO_CREATE_BOARD | 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_… | Read + write, Full access |
Create card itemMIRO_CREATE_CARD_ITEM | Create a card item on a Miro board. Use when you need to add task cards with titles, descriptions, due dates, and assignees. | Read + write, Full access |
Create connectorMIRO_CREATE_CONNECTOR | Create a connector (edge/arrow) that links two existing board items. | Read + write, Full access |
Create document itemMIRO_CREATE_DOCUMENT_ITEM | Create a document item on a Miro board by providing a URL to the document. | Read + write, Full access |
Create document item using file from deviceMIRO_CREATE_DOCUMENT_ITEM_USING_FILE_FROM_DEVICE | Create a document item on a Miro board using a URL to the document. | Read + write, Full access |
Create embed itemMIRO_CREATE_EMBED_ITEM | Create an embed item on a Miro board by providing a URL to embed content (YouTube videos, websites, etc.). | Read + write, Full access |
Create frame itemMIRO_CREATE_FRAME_ITEM | Add a frame item to a Miro board. Use frames to group and organize diagram regions (e.g., swimlanes, sections, slides). | Read + write, Full access |
Create frame item2MIRO_CREATE_FRAME_ITEM2 | DEPRECATED: Use MIRO_CREATE_FRAME_ITEM instead. | Read + write, Full access |
Create groupMIRO_CREATE_GROUP | Create a group on a Miro board by grouping multiple items together. | Read + write, Full access |
Create image item using local fileMIRO_CREATE_IMAGE_ITEM_USING_LOCAL_FILE | Create an image item on a Miro board by uploading a local image file. | Read + write, Full access |
Create items in bulkMIRO_CREATE_ITEMS_IN_BULK | Create multiple items on a Miro board in a single request. | Read + write, Full access |
Create mindmap node experimentalMIRO_CREATE_MINDMAP_NODE_EXPERIMENTAL | 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. | Read + write, Full access |
Create shape itemMIRO_CREATE_SHAPE_ITEM | DEPRECATED: Use MIRO_MIRO_CREATE_SHAPE_ITEM2 instead. | Read + write, Full access |
Create shape item2MIRO_CREATE_SHAPE_ITEM2 | 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. | Read + write, Full access |
Create sticky note itemMIRO_CREATE_STICKY_NOTE_ITEM | Create a sticky note item on a Miro board. | Read + write, Full access |
Create tagMIRO_CREATE_TAG | 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. | Read + write, Full access |
Create text itemMIRO_CREATE_TEXT_ITEM | 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. | Read + write, Full access |
Delete app card itemMIRO_DELETE_APP_CARD_ITEM | 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. | Full access |
Delete card itemMIRO_DELETE_CARD_ITEM | 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. | Full access |
Delete connectorMIRO_DELETE_CONNECTOR | 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. | Full access |
Delete document itemMIRO_DELETE_DOCUMENT_ITEM | 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'." | Full access |
Delete embed itemMIRO_DELETE_EMBED_ITEM | 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. | Full access |
Delete frame itemMIRO_DELETE_FRAME_ITEM | Delete a frame item from a Miro board. Use when you need to remove a frame that groups or organizes content on the board. | Full access |
Delete groupMIRO_DELETE_GROUP | Delete a group from a board. Use when you need to remove a group and optionally its items. | Full access |
Delete image itemMIRO_DELETE_IMAGE_ITEM | Delete an image item from a board. Use when you need to remove an image that is no longer needed. | Full access |
Delete itemMIRO_DELETE_ITEM | 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. | Full access |
Delete mindmap node experimentalMIRO_DELETE_MINDMAP_NODE_EXPERIMENTAL | 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. | Full access |
Delete shape itemMIRO_DELETE_SHAPE_ITEM | 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. | Full access |
Delete sticky note itemMIRO_DELETE_STICKY_NOTE_ITEM | Delete a sticky note item from a board. Use when you need to remove a sticky note that is no longer needed. | Full access |
Delete tagMIRO_DELETE_TAG | Delete a specific tag from a board. Use when you need to remove a tag after confirming its board and tag IDs. | Full access |
Delete text itemMIRO_DELETE_TEXT_ITEM | Delete a text item from a board. Use when you need to remove a text item after confirming its board and item IDs. | Full access |
Get all groupsMIRO_GET_ALL_GROUPS | Retrieve all groups on a Miro board with cursor-based pagination. | All levels |
Get app card item2MIRO_GET_APP_CARD_ITEM2 | Retrieve a specific app card item by its ID from a Miro board. | All levels |
Get boardMIRO_GET_BOARD | DEPRECATED: Use MIRO_GET_SPECIFIC_BOARD instead. | All levels |
Get boardsMIRO_GET_BOARDS | DEPRECATED: Use MIRO_MIRO_GET_BOARDS2 instead. | All levels |
Get boards2MIRO_GET_BOARDS2 | Retrieve accessible boards with optional filters. | All levels |
Get board itemsMIRO_GET_BOARD_ITEMS | List items on a Miro board (shapes, stickies, cards, etc.) with pagination. | All levels |
Get board membersMIRO_GET_BOARD_MEMBERS | 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 t… | All levels |
Get card itemMIRO_GET_CARD_ITEM | Retrieve a specific card item from a Miro board. | All levels |
Get connectorMIRO_GET_CONNECTOR | Retrieve a specific connector by its ID. Use when you need details about an existing connector on a board. | All levels |
Get connectorsMIRO_GET_CONNECTORS | Retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items. | All levels |
Get document itemMIRO_GET_DOCUMENT_ITEM | Retrieve a specific document item from a Miro board by its ID. | All levels |
Get embed itemMIRO_GET_EMBED_ITEM | Retrieve a specific embed item from a board by its ID. | All levels |
Get frame itemMIRO_GET_FRAME_ITEM | Retrieve a specific frame item from a Miro board. | All levels |
Get group by idMIRO_GET_GROUP_BY_ID | Retrieve a specific group by its ID. Use when you need to get details about a group on a Miro board. | All levels |
Get image itemMIRO_GET_IMAGE_ITEM | Retrieve a specific image item from a board. | All levels |
Get item tagsMIRO_GET_ITEM_TAGS | Retrieve tags attached to a specific item on a Miro board. | All levels |
Get mindmap nodes experimentalMIRO_GET_MINDMAP_NODES_EXPERIMENTAL | Retrieve mind map nodes from a Miro board. | All levels |
Get mindmap node experimentalMIRO_GET_MINDMAP_NODE_EXPERIMENTAL | Retrieve a specific mind map node from a board. | All levels |
Get oembedMIRO_GET_OEMBED | 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. | All levels |
Get shape itemMIRO_GET_SHAPE_ITEM | Retrieve a specific shape item from a Miro board by its ID. | All levels |
Get specific boardMIRO_GET_SPECIFIC_BOARD | Retrieve detailed information about a specific board by its ID. | All levels |
Get specific board memberMIRO_GET_SPECIFIC_BOARD_MEMBER | Retrieve details of a specific board member. | All levels |
Get specific itemMIRO_GET_SPECIFIC_ITEM | Retrieve a specific item from a Miro board by its ID. | All levels |
Get sticky note itemMIRO_GET_STICKY_NOTE_ITEM | Retrieve a specific sticky note item from a board by its ID. | All levels |
Get tagMIRO_GET_TAG | Retrieve details of a specific tag on a board. | All levels |
Get text itemMIRO_GET_TEXT_ITEM | Retrieve a specific text item from a Miro board by its ID. | All levels |
List board tagsMIRO_LIST_BOARD_TAGS | List all tags on a Miro board. Use when you need to discover tag IDs, titles, or colors before performing tag operations. | All levels |
List organizationsMIRO_LIST_ORGANIZATIONS | Retrieves the organization associated with the current access token. | All levels |
Share boardMIRO_SHARE_BOARD | Share a board by inviting users via email. | Read + write, Full access |
Update app card item2MIRO_UPDATE_APP_CARD_ITEM2 | 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. | Read + write, Full access |
Update boardMIRO_UPDATE_BOARD | 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. | Read + write, Full access |
Update board memberMIRO_UPDATE_BOARD_MEMBER | Update the role of a specific board member. | Read + write, Full access |
Update card itemMIRO_UPDATE_CARD_ITEM | 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. | Read + write, Full access |
Update connectorMIRO_UPDATE_CONNECTOR | Update an existing connector on a Miro board. | Read + write, Full access |
Update document itemMIRO_UPDATE_DOCUMENT_ITEM | 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. | Read + write, Full access |
Update embed itemMIRO_UPDATE_EMBED_ITEM | 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. | Read + write, Full access |
Update frame itemMIRO_UPDATE_FRAME_ITEM | 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. | Read + write, Full access |
Update groupMIRO_UPDATE_GROUP | Update a group on a Miro board with new items. | Read + write, Full access |
Update image itemMIRO_UPDATE_IMAGE_ITEM | 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. | Read + write, Full access |
Update item position or parentMIRO_UPDATE_ITEM_POSITION_OR_PARENT | Update an item's position or parent frame on a Miro board. | Read + write, Full access |
Update shape itemMIRO_UPDATE_SHAPE_ITEM | Update an existing shape item on a Miro board. | Read + write, Full access |
Update sticky note itemMIRO_UPDATE_STICKY_NOTE_ITEM | Update a sticky note item on a Miro board. | Read + write, Full access |
Update tagMIRO_UPDATE_TAG | 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. | Read + write, Full access |
Update text itemMIRO_UPDATE_TEXT_ITEM | 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. | Read + write, Full access |
Just ask in plain language: “check Miro for …”, “create … in Miro”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Miro isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Miro ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |