Introduction
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
- 🔎 Summarize and search for content: Create, search, understand, and summarise boards
- 🚧 Build boards for your workshops: Create custom structured layouts with frames, sticky notes, shapes, text, cards, docs, and tables, add images from URLs to run retros, sprint planning or strategy meetings.
- 🎨 Visualize complex ideas: create diagrams for a pull request, compare user journeys or database schemas by generating architecure, sequence flow and Entity Relationship (ERD) diagrams.
- 🗣️ Act on feedback agentically: read and resolve comments, and turn team discussion into clear next steps on the canvas.
Enterprise Users: Your Admin must enable the MCP Server for your organization before you can connect. See Admin Guide.
📚 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.
- ▶️ 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 assistant below. For everything else (Windsurf, VSCode + GitHub Copilot, Replit, Lovable, Kiro, Gemini CLI, Amazon Q), see the full Connection Guides.
Server URL (for any manual setup):https://mcp.miro.com/
Claude (Web & Desktop)
The fastest way to use Miro with Claude is to install 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.
Client-Specific Setup
For detailed instructions, visit 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.
🛠️ 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 |
🛡 Admin & Enterprise Guide
If you are on an Enterprise Plan, the MCP Server is disabled by default for security.
- Admin Guide: How to Enable Miro MCP Server
- Security Specs:
- Auth: OAuth 2.1 (Dynamic Client Registration).
- Permissions: Respects all existing board permissions and access controls.
- Compliance: Data is processed securely following Miro's enterprise standards.
🤝 Support
- Feedback: Submit Feedback Form
- Issues: Report bugs on the GitHub Repo.
- Community: Join the Miro Developer Community Discord (link to join).
Updated 6 days ago