---
updatedAt: 2026-09-17T13:29:26.000Z
---

Fetch the complete documentation index at: https://developers.miro.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Miro MCP Server Tools

Learn what you can do with Miro's MCP Server via the tools we extend to agents.

<br />

<Callout icon="👍" theme="okay">
  ### Feedback [form](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx).
</Callout>

Below are the tools AI Agents can use  to create, search, and understand context in your Miro workspace.

With a single prompt, you can create a board for a retro workshop, summarize it and create action items in a Miro table with priorities, assignees, and due dates, or visualize complex ideas in the form of diagrams on your Miro board.&#x20;

Note that these tools are subject to [usage limits](https://developers.miro.com/docs/mcp-usage-and-daily-limits).&#x20;

***

## Tools

| Title                              | Tool Name                          | Description                                                                                                                   | Type           | Uses AI Credits |
| ---------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------- |
| Image Metadata                     | `image_get_data`                   | Get image metadata and base64-encoded image data for an image item on a Miro board.                                           | Search / Read  | No              |
| Get Upload URL                     | `image_get_upload_url`             | Get a temporary, single-use presigned POST URL for uploading an image.                                                        | Write / Update | No              |
| Download Image                     | `image_get_url`                    | Get a download URL for an image item from a Miro board.                                                                       | Search / Read  | No              |
| Create Table (⚠️ Deprecating soon) | `table_create`                     | Create a table on a Miro board with specified columns.                                                                        | Write / Update | No              |
| Read Table (⚠️ Deprecating soon)   | `table_list_rows`                  | Get rows from a Miro table with column metadata and optional filtering.                                                       | Search / Read  | No              |
| Update Table (⚠️ Deprecating soon) | `table_sync_rows`                  | Add or update rows in a Miro table using key-based upsert matching.                                                           | Write / Update | No              |
| Create New Board                   | `board_create`                     | Create a new Miro board.                                                                                                      | Write / Update | No              |
| Search Boards                      | `board_search_boards`              | Search and list boards accessible to the current user.                                                                        | Search / Read  | No              |
| Read Comments                      | `comment_list_comments`            | List comments from a Miro board or a specific item on the board.                                                              | Search / Read  | No              |
| Reply to Comment                   | `comment_reply`                    | Add a reply to an existing comment thread on a Miro board.                                                                    | Write / Update | No              |
| Resolve Comment                    | `comment_resolve`                  | Resolve or unresolve a comment thread on a Miro board.                                                                        | Write / Update | No              |
| Upload Image                       | `image_create`                     | Create an image item on a Miro board.                                                                                         | Write / Update | No              |
| Create Widgets 🆕                  | `canvas_create_from_svg`           | Create multiple board items on a Miro board from SVG.                                                                         | Write / Update | No              |
| Board Layout 🆕                    | `canvas_get_canvas_composer_skill` | Get the SVG format specification for creating board layouts.                                                                  | Search / Read  | No              |
| Item Positioning 🆕                | `canvas_read_as_svg`               | Read existing board items and return them as SVG.                                                                             | Search / Read  | No              |
| Update Widgets 🆕                  | `canvas_update_from_svg`           | Apply an SVG document as a diff.                                                                                              | Write / Update | No              |
| Read Prototype Screens             | `prototype_read`                   | Read prototype screens from a Miro board, including metadata                                                                  | Search / Read  | No              |
| Create Prototype                   | `prototype_create`                 | Create a Miro prototype from one or more HTML screens, using either uploaded HTML tokens (preferred) or inline HTML contents. | Write / Update | No              |

## 🎨 What the canvas tools can do

The canvas tools describe a Miro board as an SVG document. Your agent reads the board as SVG, edits that SVG, and writes it back.&#x20;

### The canvas format handles item types which used to have a dedicated tool, but adds much more functionality than before, such as:

* **Diagrams** as native diagram widgets, authored in Mermaid inside the SVG. Flowcharts, ERDs, UML class and sequence diagrams.
* **Documents** with structured content, created, read, and edited in place.
* **Tables** with typed columns, switchable between table, grid, timeline, and kanban views.

<Callout icon="📘" theme="info">
  ### Canvas tools replace layout, diagram, context, and other tools&#x20;

  The `board_list_items`, `context_*`, `layout_*`, `diagram_*`, and `doc_*` tools were removed and can no longer be called. See [Legacy MCP board tools have been removed](https://developers.miro.com/changelog/legacy-mcp-board-tools-have-been-removed) for the full mapping. The Canvas tools cover content on a board. Images, prototypes, comments, boards, spaces, tables, and sections keep their own tools.
</Callout>

| Tool                               | When your agent calls it                                                                       |
| ---------------------------------- | ---------------------------------------------------------------------------------------------- |
| `canvas_get_canvas_composer_skill` | Once per session, before writing anything. Returns the current SVG spec.                       |
| `canvas_load_format_skill`         | On top of the base spec, for format-specific guidance such as diagramming notation.            |
| `canvas_search`                    | To find what is on a board before reading it. Supports an overview mode for a high-level pass. |
| `canvas_create_from_svg`           | To create items from an SVG document.                                                          |
| `canvas_read_as_svg`               | To read existing items back as SVG. Every item carries a stable `data-miro-id`.                |
| `canvas_update_from_svg`           | To apply an SVG document as a diff. Creates, updates, and deletes.                             |

<Callout icon="⚠️" theme="warn">
  ### The list below will grow as new widgets ship.

  Call `canvas_get_canvas_composer_skill` for the authoritative set your agent can use right now.
</Callout>

### 🆕 New item types and functionality that can be created from Canvas Tools

* **Workshop and facilitation widgets** such as polls, dot voting, planning-poker estimates, alignment scales, spinners, flip cards, and countdowns.
* **Action buttons**, **text areas**, and **emoji**s.
* **Images** placed from any reachable URL.
* **Code widgets** with syntax highlighting for languages including Python, TypeScript, SQL, and YAML.
* **Embeds and URL previews** for linked specs and designs.
* Shapes, text, cards, and custom widgets accept rotation.&#x20;
* Labels take inline formatting such as bold and italic.&#x20;
* Creation order controls z-index, so a connector drawn before its nodes sits behind them.&#x20;
* Your agent can read a frame, change one thing, and write it back without touching anything else.

# Sibling pages

* [Miro's MCP Server](https://developers.miro.com/miro-ea/docs/miro-mcp.md)
* [Getting started with Miro's MCP Server](https://developers.miro.com/miro-ea/docs/connecting-to-miro-mcp.md)
* [MCP use cases and example prompts](https://developers.miro.com/miro-ea/docs/mcp-use-cases-and-example-prompts.md)
* [Connecting Miro's MCP Server to MCP Clients](https://developers.miro.com/miro-ea/docs/connecting-miro-mcp-to-ai-coding-tools.md)
* [MCP Tutorials](https://developers.miro.com/miro-ea/docs/mcp-tutorials.md)
* [Miro MCP Server Troubleshooting](https://developers.miro.com/miro-ea/docs/miro-mcp-server-faq-and-troubleshooting.md)
* [Miro MCP Server — Frequently Asked Questions](https://developers.miro.com/miro-ea/docs/miro-mcp-server-frequently-asked-questions.md)
* [MCP Usage and Daily Limits](https://developers.miro.com/miro-ea/docs/mcp-usage-and-daily-limits.md)
* [MCP Server vs REST API](https://developers.miro.com/miro-ea/docs/mcp-server-vs-rest-api.md)
* [OIDC support for Miro MCP](https://developers.miro.com/miro-ea/docs/oidc-support-for-miro-mcp.md)

# What's next

* [Connecting Miro MCP to AI Coding Tools](https://developers.miro.com/miro-ea/docs/connecting-miro-mcp-to-ai-coding-tools.md)