Miro's MCP Server
Learn how to connect AI agents to your Miro team
Feedback form.
🚀 Miro MCP Server
Welcome to the official Miro Model Context Protocol (MCP) Server. This server bridges your AI Agents (Claude, Claude Code, Cursor, and other MCP-compatible tools like GitHub Copilot, Windsurf, and Gemini CLI) directly with your Miro boards
📈 Key use cases
Point your AI agent at a board and describe the outcome you want. Some of the most common jobs:
- 🔎 Understand a board: search, read, and summarize any board, so you can catch up on a workshop or a research wall in seconds.
- 🗂️ Run a session or workshop: build structured boards with frames, sticky notes, shapes, cards, and tables for retros, sprint planning, and strategy sessions.
- 🧩 Explore and converge on ideas: generate options, cluster them, and lay out comparison or decision matrices so a team can align on one direction.
- 🖇️ Map a process or system: create flowcharts, architecture, sequence, and ERD diagrams from a description or a pull request.
- 💬 Act on feedback: read and resolve comments, and turn board discussion into clear next steps.
Under the hood, that comes down to four capabilities: summarize and search boards, build boards, generate diagrams, and act on comments.
Try this prompt:Summarize the "Q3 Planning" Miro board [insert-miro-board URL] and list every open decision.
Want the full set of jobs with copy-paste prompts? See Use cases and example prompts.
If you are on Enterprise, we have more security controls available for your Miro Admin. See Admin Guide.
🔐 Enterprise Level Security, for all Miro users
- Uses OAuth 2.1 for auth: Secure authorization with dynamic client registration.
- Rate limiting: protected against overuse with standard API request limits. Learn more about MCP Rate Limits here.
- Permissions: Respects all existing board permissions and access controls.
📚 Core Resources
| Resource | Description |
|---|---|
| Official Documentation | Comprehensive guides and API reference. |
| GitHub Repository | Source code, Claude Skills, issue tracking, and examples. |
| Tools | Full list of available tools and capabilities. |
| Connection Guides | Step-by-step setup for various MCP clients. |
📺 Tutorials & Guides
Visual and written guides to help you build faster.
-
▶️ Recommended: YouTube Playlist: Miro MCP Tutorials
- 📝 Generate Diagrams from Code (VSCode + Copilot)
- 📝 Build a Node.js app from a Miro Board (Cursor)
- 📝 Build a Landing Page (Lovable)
⚡ Get Started
Pick your AI Agent below. For everything else (Windsurf, VSCode + GitHub Copilot, Replit, Lovable, Kiro, Gemini CLI, Amazon Q), see the full Connection Guides.
Claude (Web & Desktop)
The fastest way to use Miro with Claude is via Miro Claude Connector.
- In the Claude chat box, click the + icon → Add connectors.
- Open the Web tab and search for Miro.
- Click + on the Miro card, then Connect.
- Complete the Miro OAuth flow and select your team.
- Drop a board URL into a prompt to start.
💡 Try:Summarize the content on this board: <your-board-URL>
Full Claude setup guide →
Claude Code
- Log in with
claude. - Add the Miro MCP server:
claude mcp add --transport http miro https://mcp.miro.com - Run
/mcp authand complete the Miro OAuth flow. - Start prompting against your boards.
💡 Try:Summarize the content on this board: <your-board-URL>
Full Claude Code setup guide →
Cursor
Install the official Miro Plugin straight from Cursor.
- Open the Marketplace in Cursor.
- Search for Miro and select the Miro Plugin.
- Click Add to Cursor.
- Complete the Miro OAuth flow when prompted.
- Start prompting Cursor against your boards.
Full Cursor setup guide →
Copilot + VS Code
-
Open the MCP Registry in GitHub.
-
Click Install and add to VS Code or Insiders.
-
Complete the Miro OAuth flow when prompted.
-
Start prompting against your boards.
💻 Other MCP clients
Step-by-step guides for Windsurf, VSCode + GitHub Copilot, Replit, Lovable, Gemini CLI, Kiro IDE, Kiro CLI, and Amazon Q live in the AI Coding Tools Guide.
🛠 MCP Tools and Capabilities
Miro's MCP server exposes powerful tools to your AI agent. See the full list here.
See a comparison of REST API vs MCP Server capabilities here.
🛠️ Key Tools
| Title | Tool Name | Description | Type | Uses AI Credits |
|---|---|---|---|---|
| Create New Board | board_create | Create a new Miro board. | Write / Update | No |
| Create Widgets | layout_create | Create multiple board items on a Miro board from DSL text. | Write / Update | No |
| Update Widgets | layout_update | Edit board items using find-and-replace on their DSL representation. | Write / Update | No |
| Summarize Board | context_get | Get text context from a Miro board or a specific item on a board. | Search / Read | Yes |
| Upload Image | image_create | Create an image item on a Miro board. | Write / Update | No |
| Create Diagram | diagram_create | Create a diagram on a Miro board from DSL text. | Write / Update | No |
| Create Document | doc_create | Create a structured document item on a Miro board. | Write / Update | No |
| Create Table | table_create | Create a table on a Miro board with specified columns. | Write / Update | No |
| Search Boards | board_search_boards | Search and list boards accessible to the current user. | Search / Read | No |
| Reply to Comment | comment_reply | Add a reply to an existing comment thread on a Miro board. | Write / Update | No |
| Read Board Items | board_list_items | List items on a board with cursor-based pagination, with optional filtering by item type or parent container. | Search / Read | No |
| Find Formats | context_explore | Explore high-level items on a Miro board, such as frames, documents, prototypes, tables, and diagrams. | Search / Read | No |
| Download Image | image_get_url | Get a download URL for an image item from a Miro board. | Search / Read | No |
| Update Document | doc_update | Edit content in an existing document item using find-and-replace. | Write / Update | No |
| Update Table | table_sync_rows | Add or update rows in a Miro table using key-based upsert matching. | Write / Update | No |
| Create Code Widget | code_widget_create | Create a code widget on a Miro board. | Write / Update | No |
| Read Comments | comment_list_comments | List comments from a Miro board or a specific item on the board. | Search / Read | No |
| Resolve Comment | comment_resolve | Resolve or unresolve a comment thread on a Miro board. | Write / Update | No |
| Board Layout | layout_get_dsl | Get the DSL format specification for creating board layouts. | Search / Read | No |
| Item Positioning | layout_read | Read existing board items and return them as DSL text. | Search / Read | No |
🤝 Support
- Feedback: Submit Feedback Form
- Issues: Report bugs on the GitHub Repo.
- Community: Join the Miro Developer Community Discord (link to join).
Updated about 14 hours ago