PlugWiki
Miro logo

Miro MCP server: connect Miro boards to Claude, ChatGPT and Cursor

Official · by MiroRemote
Gethttps://mcp.miro.commiroapp/miro-aiDocs

Lets Claude, ChatGPT, Cursor or VS Code read your Miro boards and draw diagrams, docs and tables on them. You sign in with Miro, nothing to install.

This is Miro's official way to connect your AI assistant to your Miro boards, and Miro runs it for you. You can ask it to summarize a board and its comments, draw flowcharts and diagrams, add docs, tables and sticky notes, and create or share boards. It works on every Miro plan, but each plan has a daily cap on how many actions the assistant can take, and you connect to one Miro team at a time. On Enterprise plans an admin has to turn it on first.

Good for

  • Product and design teams who want board summaries, decisions and action items without reading every sticky
  • Developers who turn code or a pull request into architecture, sequence or ER diagrams
  • Developers who build from specs, wireframes and diagrams kept on a board
  • Facilitators who set up retro, workshop or planning boards from one prompt
  • Enterprise admins who want to pick which teams can connect AI tools

Works in

7 supported · 1 with issues · 6 should work

Tap an app to see how to set it up and any known problems.

Install Miro MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Miro MCP server to Claude Code. Run this command:
    
    claude plugin install miro@claude-plugins-official
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Miro account (any plan), Enterprise: admin must enable MCP first.

Read-only mode: There's no read-only mode. Set your app to ask you before it changes, deletes or shares anything on your boards.

The plugin adds the Miro server plus Miro skills for code review, specs and explaining code on a board. Restart Claude Code after installing and sign in when asked. Use only one install method in each app; a plugin plus a manual entry gives you duplicate tools and repeated sign-ins. When you sign in, pick the Miro team that holds your boards; only one team works at a time.

From the vendor's docs. Source.

Tools

  • Searches a board to find items and areas

    Searches what is on a board and where, including a quick overview mode, so the assistant knows what to read.

    Try: “What's on this board? https://miro.com/app/board/...”

    Network · canvas_search

  • Reads board items or an area in detail

    Reads part of a board, or chosen items, in full detail so the assistant can summarize or edit them.

    Try: “Summarize the architecture diagram on my Miro board”

    Network · canvas_read_as_svg

  • Adds new content to a board: diagrams, docs, stickies, shapes

    Creates new items on a board, such as flowcharts and other diagrams, documents, tables, sticky notes, shapes, code blocks and images.

    Try: “Create a flowchart on Miro showing a user login flow”

    Write · canvas_create_from_svg

  • Edits board content in place, including removing items

    Changes items already on a board by applying only the differences: it can add, edit and delete items.

    Try: “Rename the steps in this flowchart and remove the old one”

    Delete · canvas_update_from_svg

  • Finds boards you can open in your team

    Searches and lists the boards you have access to in the connected team.

    Try: “Find my Q3 planning board”

    Network · board_search_boards

  • Shows an interactive preview of a board

    Shows a clickable preview of items on a board inside the chat, in apps that support it.

    Try: “Show me a preview of the retro board”

    Network · board_show

  • Creates a new board

    Creates a new, empty Miro board.

    Try: “Create a board for next week's retro”

    Write · board_create

  • Creates a table, timeline, kanban, doc or other format

    Creates a standalone typed format, such as a table, timeline, kanban board, document, diagram, prototype or slide container.

    Try: “Create a kanban for the launch tasks”

    Write · board_create_format

  • Renames a board or changes its description or emoji

    Changes a board's title, description or icon emoji.

    Try: “Rename this board to Q4 Roadmap”

    Write · board_update_metadata

  • Finds which space a board is in

    Looks up the space a board belongs to.

    Try: “Which space is the design board in?”

    Network · board_get_space

  • Moves a board into a space or folder

    Moves a board under a different space or folder.

    Try: “Move this board into the Marketing space”

    Write · board_move

  • Moves a board to another team

    Moves a board from one Miro team to another.

    Try: “Move this board to the Design team”

    Write · board_move_to_team

From the official docs

Pros and cons

Good

  • Built and run by Miro, with nothing to install or host
  • Works on every Miro plan, including Free
  • One-click installs for Claude, ChatGPT, Codex, Cursor, VS Code and Gemini CLI
  • Draws flowcharts, sequence, class and ER diagrams on the board
  • Reads comments and can reply to or resolve them
  • Follows your existing board permissions, and Enterprise actions are audit-logged

Watch out

  • No read-only mode
  • Daily action limits: 100 on Free, 500 on Starter
  • Only one Miro team connected at a time across all your AI apps
  • Enterprise plans need an admin to turn it on
  • The September 2026 tool change broke older prompts and automations
  • Early reviews found no cloud service icons for architecture diagrams

Permissions

medium risk · 4 things to watch

Medium risk

Your assistant can change, delete and share content on any board you can open in the team you picked, and there is no read-only option. Turn on your AI app's setting that asks before it makes changes, and check sharing requests before you approve them.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete board content, not just add it

    Board updates can remove items and sections. Keep your AI app's approval prompt on for changes. developers.miro.com

  • It can share boards and spaces with others

    It can give people or groups access to a board or space and change their role. Check who it adds before you approve. developers.miro.com

  • It reaches every board you can open in the team

    Access follows your own Miro permissions in the team you pick at sign-in. Pick the team with only the boards you need. developers.miro.com

  • Enterprise admins must turn it on

    On Enterprise it is off until an admin enables it for the organization or chosen teams, and its actions show up in the audit log. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only mode is documented; the sign-in asks for board read and write access. Enterprise admins can limit MCP to selected teams.
Talks tomcp.miro.com (hosted by Miro)
Sign-in and keysSign-in with your Miro account (OAuth 2.1 with dynamic client registration). Each AI app keeps its own sign-in, but only the most recent connection works.
Scopes
  • boards:read

  • boards:write

  • openid

  • email

  • Limited to the one team chosen at sign-in and to boards that user can open

Alternatives

Use Miro's hosted server for almost everything, since it needs only a Miro sign-in. The community olgasafonova server is the pick if you want a local tool with your own access token and a wider set of board actions.

ServerOfficialRunsSign-inCan change thingsToolsStars
Miro MCPThis pageOfficialHostedMiro accountYes52–
olgasafonova/miro-mcp-serverCommunityLocalAccess tokenYes11031

What people say

People like how fast it is to set up and how quickly it drafts diagrams, and dislike the basic diagram styles and the one-team-at-a-time limit.

What people like

  • Setup takes minutes: add Miro and sign in
  • Useful for drafting a diagram of a solution that the team then talks through on the board
  • Works on every plan, including Free

Common complaints

  • Diagrams are basic: no cloud service icons for architecture drawings
  • Only one Miro team at a time, across all your AI apps
  • The move to new board tools in September 2026 left gaps, such as moving items between frames
  • Free plans get 100 actions a day, which runs out fast on big boards

In their words

Questions

What is the Miro MCP server URL?

https://mcp.miro.com/. Most apps don't need it, because Miro's plugins and connectors add it for you.

Is Miro MCP free?

Yes. It works on every Miro plan, including Free. Each plan gets a daily number of actions: 100 on Free, 500 on Starter, 2,000 on Business and 10,000 on Enterprise.

What happens when I hit the daily limit?

Your assistant gets an error and can't use Miro again until the limit resets at midnight UTC. A higher plan raises the limit.

Is it safe to connect Miro to my AI assistant?

It can only see and change boards you can already open in the team you pick. It can still delete content and share boards, so turn on your AI app's setting that asks before changes.

Why does it say the board belongs to a different team?

You are connected to another Miro team. Sign in again while viewing a board in the team you want; only one team works at a time, across all your AI apps.

Why can't I use Miro MCP at work?

On Enterprise plans it is off until an admin turns it on for the organization or your team. Ask your Miro admin.

Why do I see the Miro tools twice?

You installed it two ways, such as a plugin plus a manual entry. Remove one and sign in again.

Can it create diagrams?

Yes. It draws flowcharts, UML class and sequence diagrams and ER diagrams on the board. An early 2026 review found it could not add cloud service icons, such as AWS icons, to architecture drawings.

How do I add Miro to Claude?

On claude.ai or Claude Desktop, add Miro from the connectors directory, click Connect and pick your team. For Claude Code and other apps, use the install box above.

Examples

  • Summarize a planning board, its comments and open decisions

    Summarize the "Q3 Planning" Miro board [insert-miro-board URL] and summarize conversations in the comments. List open decisions and action items.

    Source
  • Draw a flowchart on a board

    Create a flowchart on Miro showing a user login flow

    Source
  • Explain an architecture diagram

    Summarize the architecture diagram on my Miro board

    Source
  • Turn a pull request into a diagram

    Visualize this PR [paste in PR link] on a new Miro board

    Source

Information

updated Nov 2, 2026

Publisher
Miro (official)
Endpoint
https://mcp.miro.com
Transport
Streamable HTTP
Auth
OAuth
Version
1.0.2
License
MIT
Last commit
Sep 17, 2026
Open issues
16
Listed in
Official MCP registry, Docker MCP Catalog

Miro MCP docsGitHubOfficial MCP RegistryConnecting MCP clientsMiro developer changelogIssues

Other Miro MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 19
  1. Miro's MCP Server · developers.miro.com
  2. MCP Setup Guide · github.com
  3. Miro MCP Server Troubleshooting · developers.miro.com
  4. Miro MCP Server FAQ · developers.miro.com
  5. MCP Usage and Daily Limits · developers.miro.com
  6. Miro MCP Server Tools · developers.miro.com
  7. Enterprise Guide · github.com
  8. Miro MCP OAuth protected resource metadata · mcp.miro.com
  9. Getting started with Miro's MCP Server · developers.miro.com
  10. I tried manipulating boards using Miro MCP Server from Claude Code · dev.classmethod.jp
  11. Connecting Miro's MCP Server to MCP Clients · developers.miro.com
  12. Invalid or expired consent token · github.com
  13. Cannot authenticate after using miro marketplace with claude code · github.com
  14. gemini cli auth not working · github.com
  15. Hacker News comment · news.ycombinator.com
  16. canvas_update_from_svg cannot change a widget's parent · github.com
  17. Miro AI Developer Tools README · github.com
  18. olgasafonova/miro-mcp-server README · github.com
  19. Legacy MCP board tools have been removed · developers.miro.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.