Miro MCP Server Tools & Prompts

Learn what you can do with Miro's MCP Server - including what prompts and tools you may use.

📘

This is a beta release of our MCP.

It is intended for evaluation and feedback purposes. The feature set and user experience may change in future releases. Feedback form.


📘

With Miro's Beta MCP Server release, we currently support two use cases:

  1. Generate diagrams on a Miro board based on PRD, code, or text
  2. Generate code based on Miro board content such as PRDs, diagrams, and images.

We are working on supporting more use cases, so stay tuned for updates. Please use feedback form linked above to give us feedback on more use cases.

Now that you have installed and authorized Miro's remote MCP server, let's explore how AI assistants can use MCP tools to create, search, and understand context in your Miro workspace.

These tools work seamlessly together through prompts, and their real power comes from combining them. With a single prompt, you can search your Miro board, find relevant context such as a PRD (Product Requirement Document), and create an app or diagram based on board context. Understanding these building blocks helps you craft efficient prompts that tackle complex tasks by combining multiple tools.

Prompts

NameDescription
code_create_from_boardAnalyze a Miro board to understand the project/feature requirements, generate comprehensive documentation, and provide implementation guidance. This prompt follows a two-phase approach: first analyse and recommend document types, then generate specific documentation in the AI tool you're using based on recommendations.
code_explain_on_boardExplain code implementation by creating visual diagrams and documentation on a Miro board. This prompt helps transform code into clear visual explanations including architecture diagrams, data flows, and component relationships.

Tools

NameDescriptionUses Miro AI Credits
board_list_itemsList items on a board with cursor-based pagination, supporting filters by item type and parent container.No
context_exploreDiscover high-level items on a board (frames, documents, prototypes, tables, diagrams) with their URLs and titles.No
context_getGet text context from a specific board item (documents return HTML, prototype screens return UI markup, frames return AI summaries).Yes
diagram_createCreate a diagram on a Miro board from DSL text (supports flowchart, UML class, UML sequence, and ERD).No
diagram_get_dslGet the DSL format specification (rules, syntax, color guidelines, examples) for a diagram type before creating diagrams.No
doc_createCreate a doc format item (structured document with markdown support for headings, bold, italic, lists, links) on a Miro board.No
doc_getRead the markdown content and version of an existing doc format item from a Miro board.No
doc_updateEdit content in an existing doc format item using find-and-replace (supports single or all occurrences).No
image_get_urlGet the download URL for an image item from a Miro board.No
image_get_dataRetrieve the actual binary image data (base64-encoded) for an image item from a Miro board.No
table_createCreate a table on a Miro board with specified columns (supports text and select column types).No
table_list_rowsGet rows from a Miro table with column metadata, supporting filtering by column value and cursor-based pagination.No
table_sync_rowsAdd new rows or update existing rows in a table using key-based upsert matching.No

Rate limits

Standard API request limits apply per user's usage of Miro MCP (totaled across all tool calls). See rate limit documentation.

Some MCP tools have additional, tool-specific rate limits that are stricter. These are subject to change at any time.

What to do if you're rate-limited

In general, if you encounter rate limit errors, prompt your LLM tool to reduce the amount of parallel searches or operations performed using Miro MCP, and/or try again later. You can also reach out in Miro's Developer Discord channel to ask for guidance.