# Miro — MCP server on mcp.ai
> Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually

By: mcp.ai · official
Page: https://mcp.ai/miro

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_miro?ms=1781542320000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/miro/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/miro/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/miro/skill.md
Postman collection (v2.1): https://mcp.ai/miro/postman.json

## Tools
- miro_create_board(name: string, policy?: object, teamId?: string, projectId?: string, description?: string) — Tool to 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".
- miro_delete_app_card_item(item_id: string, board_id: string) — Tool to 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.
- miro_delete_document_item(item_id: string, board_id: string) — Tool to 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 boar
- miro_delete_item(item_id: string, board_id: string) — Tool to 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.
- miro_get_app_card_item(item_id: string, board_id: string) — Tool to retrieve a specific app card item by its id. use when you need the details of an existing app card item.
- miro_get_board(board_id: string) — Tool to retrieve details of a specific board. use when you have a board id and need to fetch its metadata.
- miro_get_board_members(limit?: integer, cursor?: string, board_id: string) — Tool to 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.
- miro_get_boards(sort?: string, limit?: integer, owner?: string, query?: string, offset?: integer, team_id?: string, project_id?: string) — Tool to retrieve accessible boards with optional filters. use when you need to list or search boards by team, project, owner, or keywords.
- miro_get_connectors(limit?: integer, cursor?: string, board_id: string) — Tool to retrieve a list of connectors on a board. use after confirming the board id and when you need to page through connector items.
- miro_get_tag(tag_id: string, board_id: string) — Tool to retrieve details of a specific tag on a board. use when you have a board id and tag id and need its metadata.
- miro_list_organizations() — Tool to retrieve list of organizations accessible to the user. use when you need to view all available organizations.
- miro_miro_create_app_card_item(data: object, style?: object, parent?: object, board_id: string, geometry?: object, position?: object) — Tool to 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 (e.g., after assembling card data).
- miro_update_app_card_item(data?: object, style?: object, parent?: object, item_id: string, board_id: string, geometry?: object, position?: object) — Tool to update an app card item on a board. use when you need to modify properties of an existing app card item. include only fields to change.
- miro_update_board(name?: string, policy?: object, teamId?: string, board_id: string, projectId?: string, description?: string) — Tool to 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.

## Links
Docs: https://mcp.ai/docs/mcps/miro
Website: https://mcp.ai/mcps/miro