> This page is for Agent Handler.

> 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