Merge Unified's Miro integration Merge Agent Handler's Miro MCP server

Connect your AI Agents to Miro in minutes

Merge lets you securely connect your agents to Miro and thousands of tools instantly

Start building for free

Read docs

Miro

Learn more about Merge Agent Handler

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

validate_credential

Validate Miro credentials. Verifies credentials during setup.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Miro MCP server

Explore other MCP servers built and managed by Merge

Jira Service Management

Kintone

Klaviyo

Linear

Looker

Lucidchart

Make

Microsoft Teams

Microsoft Teams GCC High

Monday.com

n8n

NetSuite

Notion

NPI Registry

OneDrive

OneNote

Oracle HCM

Oracle Sales Cloud

Oracle SCM

Oura

Outlook

PagerDuty

PayPal

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now