👍
Feedback form.

🚀 Miro MCP Server

Welcome to the official Miro Model Context Protocol (MCP) Server. This server bridges your AI assistants (like Cursor, Claude, and GitHub Copilot) directly with your Miro boards, enabling them to read context, generate code based on items on a Miro board, and visualize complex code & logic through diagrams.

🔐 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 & Prompts	Full list of available capabilities and prompt commands.
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)

⚡ Quick Start: Configuration

To connect most MCP clients, add the Miro MCP URL to your configuration file.

Server URL:
https://mcp.miro.com/

Generic Configuration (JSON)

Add this snippet to your mcp.json or tool settings:

{
  "mcpServers": {
    "miro-mcp": {
      "url": "https://mcp.miro.com/",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Client-Specific Setup

For detailed instructions, visit the AI Coding Tools Guide.

Cursor: Settings > Features > MCP Servers > Add new (Type: HTTP).
Claude Code: Run claude mcp add --transport http miro https://mcp.miro.com.
VSCode + GitHub Copilot: Edit mcp.json via Command Palette (MCP: Open User Configuration).
Windsurf: Cascade > Manage MCPs > Configure.
Lovable: Project Settings > Integrations > Miro.
Replit: Install via the "Add Miro MCP" button in the Replit interface.
Kiro CLI: Add to .kiro/settings/mcp.json.

🛠 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).