attach_tag_to_item
Attach an existing tag to an item on the board
LABSCO SUMMARY
The tool descriptions carry the API's sharp edges rather than hiding them.
Colour names instead of hex codes, a floor of 10 on get_board_items, no height on text items, and a cap of 20 per bulk request. Those constraints are the vendor's own words and they decide how the calls get written: create_sticky_note and create_tag want predefined colour names and reject hex, create_text supports width but not height because the Miro API does not, and get_board_items will not accept a limit below 10. The bulk calls are described as sequential API calls behind a single tool, so batching saves round trips to this server rather than requests to Miro. create_connector needs its start and end items on the board already, which forces item creation to complete before any arrow is drawn. create_webhook is marked experimental, which is the one place here worth treating as provisional.
What it is
A Miro board server: it lists, creates, copies and deletes boards, creates and updates the items on them, groups and tags those items, searches a board by text, and subscribes to board events.
What you get
- Board lifecycle:
list_boardswith an optionalqueryfilter andteamId, plusget_board,create_board,update_board,copy_boardanddelete_board. - Item creation across the Miro types:
create_sticky_note,create_text,create_shape,create_card,create_frame,create_imageandcreate_documentfrom a URL,create_embedfor embedded content, andcreate_connectorbetween items already on the board, with an optionalcaption. - Reading the canvas:
get_board_itemsfiltered bytypeandparentItemId,get_itemfor one item's detail,get_frames,get_items_in_frame, andsearch_itemsby content or text. - Batched writes capped at 20 per request:
bulk_create_items,bulk_update_items,bulk_delete_itemsandbulk_create_connectors. - Organisation on the board:
create_groupfor existing items,get_tags,create_tag,attach_tag_to_itemandremove_tag_from_item. - Collaboration:
get_board_membersreturns everyone with access, andshare_board_with_userinvites byemailwith aroleand an optionalmessage. - Event subscriptions:
create_webhookfor board events against acallbackUrl, andget_webhooksto list what is subscribed.
Requirements
A Miro OAuth token with access to the boards you intend to touch, supplied as MIRO_OAUTH_TOKEN.
Setup effort
One command plus a key — npm install @aditya.mishra/miro-mcp, then supply credentials
USE CASES
01
Turning raw notes into a laid-out board
Put down a frame to hold the work, then place the sticky notes and shapes inside it at coordinates you control.
02
Drawing a diagram whose boxes must exist before the arrows
Create the items in a batch, then connect them in a second batch, because a connector needs its start and end items already on the board.
03
Reading back a board you did not build
Find the board, list what is on it by item type, and search the canvas by the text you remember.
04
Reorganising a board without clicking through it
Move and restyle items in batches, gather the related ones together, and label them so the board stays readable.
05
Getting a finished board in front of the people who need it
Check who already has access, then invite the missing collaborators by email at the role you intend.
35 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
bulk_create_connectors
Create multiple connectors at once efficiently (max 20 connectors per request, implemented via sequential API calls)
bulk_create_items
Create multiple items at once efficiently (max 20 items per request, implemented via sequential API calls)
bulk_delete_items
Delete multiple items at once efficiently (max 20 items per request, implemented via sequential API calls)
bulk_update_items
Update multiple items at once efficiently (max 20 items per request, implemented via sequential API calls)
copy_board
Copy an existing board
create_board
Create a new Miro board
create_card
Create a card item with title and description
create_connector
Create a connector/line between two existing items (CRITICAL: both items must already exist on the board)
create_document
Create a document item from a URL
create_embed
Create an embedded content item from a URL
create_frame
Create a frame container to organize other items
create_group
Group multiple existing items together
create_image
Create an image item from a URL
create_shape
Create a geometric shape with content and styling options
create_sticky_note
Create a sticky note with predefined color names (REQUIRED: use color names, not hex codes)
create_tag
Create a new tag with predefined color names (CRITICAL: use predefined color names, NOT hex colors)
create_text
Create a text item (LIMITATION: text items only support width in geometry, height is NOT supported by Miro API)
create_webhook
Create a webhook subscription for board events (experimental feature)
delete_board
Delete a board
delete_item
Delete an item from the board (handles empty API responses correctly)
get_board
Get detailed information about a specific board
get_board_items
Get all items from a board with filtering options (Note: minimum limit is 10, not less)
get_board_members
Get all members with access to a board
get_frames
Get all frame items from a board
get_item
Get detailed information about a specific item on the board
get_items_in_frame
Get all items contained within a specific frame
get_tags
Get all tags from a board
get_webhooks
Get all webhook subscriptions
list_boards
List all available Miro boards with optional query filter
remove_tag_from_item
Remove a tag from an item on the board
search_items
Search for items on a board by content/text
share_board_with_user
Invite a user to collaborate on a board via email
update_board
Update board properties
update_item
Update any item properties (position, style, data, etc.)
BEFORE YOU INSTALL
What to know first
Tools you get
35 tools when we connected. The documented categories overlap and add to 41, but there are 35 distinct tools. The webhook feature is experimental, and bulk operations run as sequential API calls capped at 20 items.
Requires
- npx on PATH
- MIRO_OAUTH_TOKEN in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 35 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install @aditya.mishra/miro-mcpMCP Clients
Claude Desktop, Cline
JSON
{
"mcpServers": {
"miro-mcp": {
"command": "npx",
"args": [
"@aditya.mishra/miro-mcp"
],
"env": {
"MIRO_OAUTH_TOKEN": "<YOUR_MIRO_OAUTH_TOKEN>"
}
}
}
}Continue
CONTINUE · JSON
{
"mcpServers": [
{
"name": "miro-mcp",
"command": "npx",
"args": [
"@aditya.mishra/miro-mcp"
],
"env": {
"MIRO_OAUTH_TOKEN": "<YOUR_MIRO_OAUTH_TOKEN>"
}
}
]
}
