
Miro MCP server: connect Miro boards to Claude, ChatGPT and Cursor
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.
Miro's docs: install the official Miro plugin, then sign in when Claude Code asks.
Known problems
- Fixed
Sign-in failed after installing from the plugin marketplace
Reported Mar 2026 · GitHub
Miro's docs: install Miro from the Cursor marketplace, then sign in. developers.miro.com
Miro's docs: install it from the GitHub MCP registry, then sign in. developers.miro.com
Miro's docs: add the server address to Windsurf's MCP settings, then sign in and pick a team. developers.miro.com
Miro's docs: Codex uses the same Miro plugin as ChatGPT. developers.miro.com
Miro's docs: install the Miro extension for Gemini CLI, restart it and sign in.
Known problems
- Closed
Sign-in did not work from Gemini CLI
Reported Mar 2026 · GitHub
Miro's docs: add Miro from the ChatGPT plugin directory, then click Connect. developers.miro.com
Miro's docs: add Miro from Claude's connector directory, click Connect and pick your team.
Known problems
- Open
Sign-in stops before the team picker for some users
Workaround: Miro staff suggested clearing all browser cookies.
Since May 2026 · GitHub
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Miro MCP
Claude Code
- 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
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_searchReads 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_svgAdds 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_svgEdits 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_svgFinds 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_boardsShows 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_showCreates a new board
Creates a new, empty Miro board.
Try: “Create a board for next week's retro”
Write ·
board_createCreates 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_formatRenames 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_metadataFinds 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_spaceMoves 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_moveMoves 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_teamRestores boards from the trash
Brings one or more boards back from the trash.
Try: “Restore the board I deleted yesterday”
Write ·
board_restoreCreates a table on a board
Creates a table on a board with the columns you specify.
Try: “Add a table of action items with owner and due date”
Write ·
table_createReads the rows of a table
Reads rows and column details from a table on a board.
Try: “List the open action items in this table”
Network ·
table_list_rowsAdds or updates rows in a table
Adds new rows or updates existing ones in a table.
Try: “Mark the API task as done in the tracker table”
Write ·
table_sync_rowsSwitches a table to grid, timeline or kanban view
Changes how a table is shown: as a grid, a timeline or a kanban board.
Try: “Show the tasks table as a kanban”
Write ·
table_update_viewShows the history of a row's latest update
Shows the past values of a row's Latest Update field.
Try: “How has the status of the billing row changed?”
Network ·
table_get_latest_update_historyReads comments on a board or item
Lists the comments on a board or on a specific item.
Try: “Summarize the comments on this board”
Network ·
comment_list_commentsAdds a comment on the board
Posts a new comment on the board canvas.
Try: “Comment on the pricing frame asking for a final number”
Write ·
comment_createReplies to a comment thread
Adds a reply to an existing comment thread.
Try: “Reply to Sam's comment that the copy is approved”
Write ·
comment_replyResolves or reopens a comment thread
Marks a comment thread as resolved, or reopens it.
Try: “Resolve the comments we've addressed”
Write ·
comment_resolveLooks at an image on a board
Gets the image itself so the assistant can see what it shows.
Try: “What does the screenshot in the top frame show?”
Network ·
image_get_dataGets a download link for an image
Returns a link to download an image from a board.
Try: “Give me a link to download the logo image”
Network ·
image_get_urlAdds an image to a board
Places an image item on a board.
Try: “Add this screenshot to the board”
Write ·
image_createReads prototype screens from a board
Reads the screens of a Miro prototype on a board.
Try: “Turn the prototype screens on this board into React components”
Network ·
prototype_readCreates a prototype from HTML screens
Creates a Miro prototype from one or more HTML screens.
Try: “Make a clickable prototype of these three screens”
Write ·
prototype_createImports a design into Miro from a public link
Brings a design into Miro from a publicly reachable URL.
Try: “Import this Claude design into my board”
Write ·
import-claude-design-from-urlLists the spaces in your team
Lists the spaces in the connected team.
Try: “What spaces does my team have?”
Network ·
space_listLists the boards in a space
Lists the boards inside one space.
Try: “Which boards are in the Product space?”
Network ·
space_list_boardsLists what is inside a space or section
Lists the direct contents of a space or section, one level deep.
Try: “What's in the Research section?”
Network ·
space_list_childrenCreates a new space
Creates a new space for grouping boards.
Try: “Create a space for the Q4 launch”
Write ·
space_createRenames a space or changes its description or emoji
Changes a space's title, description or icon emoji.
Try: “Rename the space to Launch 2027”
Write ·
space_update_metadataCreates a section inside a space
Creates a section in a space to group related boards and content.
Try: “Add a Research section to the Product space”
Write ·
section_createRenames or reorders a section
Renames a section or changes its position among other sections.
Try: “Move the Research section to the top”
Write ·
section_update_metadataDeletes a section
Deletes a section from a space.
Try: “Delete the empty Drafts section”
Delete ·
section_deleteLists the updates posted in a space
Lists the blog posts or updates in a space's overview.
Try: “What updates were posted in the Launch space?”
Network ·
blog_post_listPosts an update in a space
Creates a new blog post or update in a space's overview.
Try: “Post a weekly update in the Launch space”
Write ·
blog_post_createEdits an update posted in a space
Changes an existing blog post in a space's overview.
Try: “Fix the date in this week's update”
Write ·
blog_post_updateShows who can access a board or space
Lists the people and groups with access to a board or space and their roles.
Try: “Who has access to this board?”
Network ·
content_item_list_rolesShares a board with a person or group
Gives a user or group access to a board with a chosen role.
Try: “Share this board with the design team as editors”
Write ·
board_shareChanges someone's role on a board
Changes the role of a person or group who already has access to a board.
Try: “Make Alex a viewer on this board”
Write ·
board_role_updateShares a space with a person or group
Gives a user or group access to a space with a chosen role.
Try: “Share the Launch space with marketing”
Write ·
space_shareChanges someone's role in a space
Changes the role of a person or group who already has access to a space.
Try: “Make the contractors viewers in this space”
Write ·
space_role_updateFinds people in your organization
Searches people in your organization and returns their name, email and user ID.
Try: “Find Priya's Miro account”
Network ·
user_search_organization_usersGets your company's brand colors, fonts and guidelines
Gets the organization's brand theme, guidelines and assets so new content matches your brand.
Try: “Make this board match our brand colors”
Network ·
get_brand_contextUsed by the assistant behind the scenes
Checks which Miro account is signed in
Returns the signed-in Miro user so the assistant knows who you are.
Try: “Which Miro account am I using?”
Network ·
user_who_am_iLoads the instructions for writing to boards
Gets the board-writing instructions and format the assistant reads once before it creates anything.
Network ·
canvas_get_canvas_composer_skillLoads extra instructions for one format, like diagrams
Gets extra guidance for a specific format, such as diagram notation, on top of the general instructions.
Network ·
canvas_load_format_skillReserves upload slots for HTML content
Reserves upload slots so HTML documents can be sent separately before they are placed on a board.
Network ·
canvas_get_html_upload_urlGets a one-time upload link for a local image
Gets a single-use link to upload an image from your computer before it is placed on a board.
Network ·
image_get_upload_urlGets upload links for HTML prototype screens
Reserves single-use upload slots for HTML screens before a prototype is created.
Network ·
prototype_get_upload_url
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-only | No read-only mode is documented; the sign-in asks for board read and write access. Enterprise admins can limit MCP to selected teams. |
|---|---|
| Talks to | mcp.miro.com (hosted by Miro) |
| Sign-in and keys | Sign-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 |
|
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.
| Server | Official | Runs | Sign-in | Can change things | Tools | Stars |
|---|---|---|---|---|---|---|
| Miro MCPThis page | Official | Hosted | Miro account | Yes | 52 | – |
| olgasafonova/miro-mcp-server | Community | Local | Access token | Yes | 110 | 31 |
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
“Setting up the Miro MCP Server itself is very simple and can be completed in minutes.”Obuchi HugoBlogMar 2026
“currently you can't create AWS architecture diagrams with service icons.”Obuchi HugoHacker NewsFeb 2026
“We use Miro at work for diagramming. Lots of visual people on the team, myself included. Using Miro's MCP I draft a solution to a problem and have Miro diagram it.”abustamam
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.
SourceDraw a flowchart on a board
Create a flowchart on Miro showing a user login flow
SourceExplain an architecture diagram
Summarize the architecture diagram on my Miro board
SourceTurn 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 19Hide
- Miro's MCP Server · developers.miro.com
- MCP Setup Guide · github.com
- Miro MCP Server Troubleshooting · developers.miro.com
- Miro MCP Server FAQ · developers.miro.com
- MCP Usage and Daily Limits · developers.miro.com
- Miro MCP Server Tools · developers.miro.com
- Enterprise Guide · github.com
- Miro MCP OAuth protected resource metadata · mcp.miro.com
- Getting started with Miro's MCP Server · developers.miro.com
- I tried manipulating boards using Miro MCP Server from Claude Code · dev.classmethod.jp
- Connecting Miro's MCP Server to MCP Clients · developers.miro.com
- Invalid or expired consent token · github.com
- Cannot authenticate after using miro marketplace with claude code · github.com
- gemini cli auth not working · github.com
- Hacker News comment · news.ycombinator.com
- canvas_update_from_svg cannot change a widget's parent · github.com
- Miro AI Developer Tools README · github.com
- olgasafonova/miro-mcp-server README · github.com
- Legacy MCP board tools have been removed · developers.miro.com