Miro MCP Server Tools

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


👍

Feedback form.

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.

Note that these tools are subject to usage limits.


Tools

🎨 Canvas

TitleTool NameDescriptionType
Create Board from SVGcanvas_create_from_svgCreate board items from a canvas-composer SVG document.Write / Update
Update Board from SVGcanvas_update_from_svgApply a canvas-composer SVG document to the board by diffing it against the live board (matched on data-miro-id) and applying only the deltas.Write / Update
Read Board as SVGcanvas_read_as_svgRead one board area or specific items as a canvas-composer SVG document.Search / Read
Search Canvascanvas_searchSearch and navigate board content on top of the canvas-composer SVG representation to find relevant items and areas.Search / Read
Canvas Composercanvas_get_canvas_composer_skillGet the board-authoring workflow instructions and the DSL (Domain-Specific Language) format specification for creating board items.Search / Read
Load Format Skillcanvas_load_format_skillLoad supplementary authoring guidance (a skill) for a specific composition format, layered ON TOP OF the general canvas format.Search / Read
Get HTML Upload URLcanvas_get_html_upload_urlReserve slots for uploading html_content documents out of band.Search / Read

📋 Boards

TitleTool NameDescriptionType
Create New Boardboard_createCreate a new Miro board.Write / Update
Create Board Formatboard_create_formatCreate a typed board format, such as a table, timeline, kanban, document, diagram, prototyping container, slide container, activities board, or embed.Write / Update
Search Boardsboard_search_boardsSearch and list boards accessible to the current user, scoped to their team.Search / Read
Show Board Previewboard_showShow a single interactive preview of items on a Miro board.Search / Read
Get Board Spaceboard_get_spaceFind which space a board belongs to.Search / Read
Move Boardboard_moveMove an existing Miro board under a space or folder.Write / Update
Move Board To Teamboard_move_to_teamMove a board to a different team.Write / Update
Restore Boardsboard_restoreRestore one or more boards from trash.Write / Update
Update Board Metadataboard_update_metadataUpdate a board's title, description and/or icon emoji.Write / Update

🔐 Sharing and access

TitleTool NameDescriptionType
List Content Item Rolescontent_item_list_rolesList who can access a board or space and the role each of them holds.Search / Read
Share Boardboard_shareGrant a user or user group access to a board with a specific role.Write / Update
Update Board Roleboard_role_updateChange the role of a user or user group that already has access to a board.Write / Update
Share Spacespace_shareGrant a user or user group access to a space with a specific role.Write / Update
Update Space Rolespace_role_updateChange the role of a user or user group that already has access to a space.Write / Update

📁 Spaces and sections

TitleTool NameDescriptionType
Create New Spacespace_createCreate a new Miro space.Write / Update
List Team Spacesspace_listList the spaces in the current user's team.Search / Read
List Space Boardsspace_list_boardsList the boards inside one specific space.Search / Read
List Space Or Section Childrenspace_list_childrenList the direct children of a space or section, one level deep.Search / Read
Update Space Metadataspace_update_metadataUpdate a space's title, description and/or icon emoji.Write / Update
Create Sectionsection_createCreate a new section inside a space to group related boards and content.Write / Update
Update Section Metadatasection_update_metadataRename a section or change its position among sibling sections.Write / Update
Delete Sectionsection_deleteDelete a section.Write / Update
Create Space Blog Postblog_post_createCreate a new blog post in a Miro space overview.Write / Update
List Space Blog Postsblog_post_listList all blog posts or updates or feed in a Miro space overview.Search / Read
Update Space Blog Postblog_post_updateUpdate an existing blog post in a Miro space overview.Write / Update

🗂️ Tables

TitleTool NameDescriptionType
Create Tabletable_createCreate a table on a Miro board with specified columns.Write / Update
Read Tabletable_list_rowsGet rows from a Miro table with column metadata.Search / Read
Update Tabletable_sync_rowsAdd or update rows in a Miro table.Write / Update
Update Table Viewtable_update_viewUpdate a Miro table widget's view: switch it to a grid table, timeline, or kanban board.Write / Update
Read Latest Update Historytable_get_latest_update_historyGet the history of a row's Latest Update field.Search / Read

💬 Comments

TitleTool NameDescriptionType
Read Commentscomment_list_commentsList comments from a Miro board or a specific item on the board.Search / Read
Create Canvas Commentcomment_createCreate a new comment on the Miro board canvas.Write / Update
Reply to Commentcomment_replyAdd a reply message to an existing comment thread on a Miro board.Write / Update
Resolve Commentcomment_resolveResolve or unresolve a comment thread on a Miro board.Write / Update

🖼️ Images

TitleTool NameDescriptionType
Image Dataimage_get_dataGet the pixels of an image item on a Miro board.Search / Read
Download Imageimage_get_urlGet image download URL for an image item from a Miro board.Search / Read
Get Upload URLimage_get_upload_urlGet a single-use upload URL for a local image.Search / Read
Create Imageimage_createCreate an image item on a Miro board.Write / Update

📱 Prototypes and design import

TitleTool NameDescriptionType
Read Prototype Screensprototype_readRead prototype screens from a Miro board.Search / Read
Create Prototypeprototype_createCreate a Miro prototype from one or more HTML screens.Write / Update
Get HTML Upload URLprototype_get_upload_urlReserve one or more single-use upload slots for HTML screens.Search / Read
Import Claude Designimport-claude-design-from-urlImport a design into Miro from a publicly fetchable URL.Write / Update

🙋🏻Users and brand

TitleTool NameDescriptionType
Who Am Iuser_who_am_iReturns the identity of the current authenticated user.Search / Read
Search Organization Usersuser_search_organization_usersSearch for people in the current user's organization and return their name, email, and user id.Search / Read
Get Brand Contextget_brand_contextGet the organization's brand identity for styling content you author: the brand theme (colors, typography), guidelines rendered for direct use, and a brand asset summary.Search / Read

🎨 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.

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.
📘

Canvas tools replace layout, diagram, context, and other tools

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 for the full mapping. The Canvas tools cover content on a board. Images, prototypes, comments, boards, spaces, tables, and sections keep their own tools.

ToolWhen your agent calls it
canvas_get_canvas_composer_skillOnce per session, before writing anything. Returns the current SVG spec.
canvas_load_format_skillOn top of the base spec, for format-specific guidance such as diagramming notation.
canvas_searchTo find what is on a board before reading it. Supports an overview mode for a high-level pass.
canvas_create_from_svgTo create items from an SVG document.
canvas_read_as_svgTo read existing items back as SVG. Every item carries a stable data-miro-id.
canvas_update_from_svgTo apply an SVG document as a diff. Creates, updates, and deletes.
⚠️

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.

🆕 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 emojis.
  • 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.
  • Labels take inline formatting such as bold and italic.
  • Creation order controls z-index, so a connector drawn before its nodes sits behind them.
  • Your agent can read a frame, change one thing, and write it back without touching anything else.

Did this page help you?