> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Miro

**Authentication:** OAuth or access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List boards in the `Product` team last edited in the past 7 days.
* Add a sticky note to the `Sprint Retro` board summarizing today's takeaways.
* Find boards shared externally in the last 30 days.

## Available Tools

#### list_boards

List all boards accessible to the authenticated user with filtering and pagination support

#### get_board

Retrieve detailed information about a specific Miro board by its ID

#### create_board

Create a new Miro board with specified name, description, team, and policy settings

#### update_board

Update properties of an existing Miro board including name, description, and policy settings

#### delete_board

Permanently delete a Miro board and all its contents

#### get_board_members

List all members of a specific Miro board with their roles and permissions

#### create_connector

Create a connector line between two items on a Miro board

#### list_connectors

List all connectors on a Miro board with pagination support

#### get_connector

Retrieve detailed information about a specific connector on a Miro board

#### update_connector

Update properties of an existing connector including caption, styling, and endpoints

#### delete_connector

Delete a connector from a Miro board

#### create_frame

Create a new frame on a Miro board to organize and group content

#### get_frame

Retrieve detailed information about a specific frame on a Miro board

#### get_items_within_frame

List all items contained within a specific frame on a Miro board

#### update_frame

Update properties of an existing frame including title, style, and position

#### delete_frame

Permanently delete a frame from a Miro board

#### create_group

Create a new group by grouping multiple items together on a Miro board

#### list_groups

List all groups on a Miro board with pagination support

#### get_group

Retrieve detailed information about a specific group on a Miro board

#### get_group_items

Retrieve all items that belong to a specific group on a Miro board

#### update_group

Update the membership of an existing group by changing which items belong to it

#### ungroup_items

Delete a group and ungroup all its items on a Miro board

#### create_image_from_url

Create a new image item on a Miro board from a URL

#### get_image

Retrieve detailed information about a specific image item on a Miro board

#### update_image

Update properties of an existing image item including title, position, and size

#### delete_image

Permanently delete an image item from a Miro board

#### list_board_items

List all items on a Miro board with filtering by type and pagination support

#### get_item

Retrieve detailed information about a specific item on a Miro board

#### create_sticky_note

Create a new sticky note on a Miro board with content, position, and styling

#### create_shape

Create a new shape on a Miro board with specified type, content, position, and styling

#### create_card

Create a new card on a Miro board with title, description, assignee, and due date

#### update_item

Update properties of an existing item on a Miro board including content, style, and position

#### delete_item

Permanently delete an item from a Miro board

#### create_tag

Create a new tag on a Miro board for organizing and categorizing content

#### list_tags

List all tags on a Miro board with pagination support

#### get_tag

Retrieve detailed information about a specific tag on a Miro board

#### update_tag

Update properties of an existing tag including title and color

#### delete_tag

Permanently delete a tag from a Miro board

#### attach_tag_to_item

Attach an existing tag to a specific item on a Miro board

#### remove_tag_from_item

Remove a tag from a specific item on a Miro board

#### get_items_by_tag

Retrieve all items on a Miro board that have a specific tag attached

#### get_tags_from_item

Retrieve all tags attached to a specific item on a Miro board

#### create_text

Create a new text item on a Miro board with content, position, and styling

#### get_text

Retrieve detailed information about a specific text item on a Miro board

#### update_text

Update properties of an existing text item including content, style, and position

#### delete_text

Permanently delete a text item from a Miro board