🚀 Miro MCP Server (Beta)

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.

⚠️ Beta Notice: This is a beta release. Features and UX are subject to change.
🔐 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.

🛠 Features: Tools & Prompts

Miro’s MCP server exposes powerful tools to your AI agent. See the full list here.

🛠️ Key Tools

Tool Name	Description	Uses Miro AI Credits
`board_get_items`	Find and retrieve items from a specific board.	No
`board_get_image_data`	Retrieve image data from the board for visual analysis.	No
`context_get_board_docs`	Summarize a board's content to give the AI context.	Yes
`draft_diagram_new`	Create new diagrams (flowcharts, sequence, etc.) directly on the board.	Yes
`board_get_image_download_url`	Get a direct download URL for images on the board.	No

🤖 Key Prompts

Prompt Name	Usage	Use Case
`code_create_from_board`	"Look at this wireframe and..."	Analyzes board content (PRDs, wireframes) to generate code.
`code_explain_on_board`	"Explain this code logic..."	Visualizes complex code logic by creating diagrams on your board

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