Miro MCP Server

Miro AI Developer Tools

Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.

---

Share your feedback.

---

What's in This Repository?

This repo provides everything you need to connect AI tools to Miro:

Component	What It Does
Miro MCP Server	API that gives AI agents access to your Miro boards
Plugins & Extensions	Pre-built integrations for popular AI tools
Documentation	Guides for using and developing integrations

Supported AI Tools

AI Tool	Integration
Claude Code	Plugins
Gemini CLI	Extensions
Codex	Local plugins
Kiro	Power
Agent Skills	Skills
Cursor, VSCode, Windsurf, etc.	MCP Config

---

Quick Start

Step 1: Choose Your AI Tool

Select your AI tool below and follow the installation steps.

Step 2: Install

<details open> <summary><strong>Claude Code</strong> (Recommended)</summary>

/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-ai

The miro plugin bundles all skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table) and the Miro MCP server.

Restart Claude Code after installation. If you previously configured Miro MCP manually, remove the duplicate to avoid conflicts — the plugin already manages the MCP connection for you.

See Claude Code Plugins for full documentation.

</details> <details> <summary><strong>Gemini CLI</strong></summary>

gemini extensions install https://github.com/miroapp/miro-ai

Gemini CLI installs the repo as an extension, registers the Miro MCP server from gemini-extension.json, and auto-discovers the 7 bundled skills from skills/. Restart Gemini CLI and authenticate when prompted.

See Gemini CLI Extension | Official Docs

</details> <details> <summary><strong>Kiro</strong></summary>

1. Open the Powers panel in Kiro
2. Click Add power from GitHub
3. Enter: miroapp/miro-ai and select powers/code-gen

For local development, see CONTRIBUTING.md.

See Kiro Powers | Official Docs

</details> <details> <summary><strong>Agent Skills</strong> (agentskills.io)</summary>

Portable knowledge skills that work across AI coding tools (Claude Code, Cursor, VS Code + Copilot, Codex, etc.).

npx skills add miroapp/miro-ai                       # Interactive install
npx skills add miroapp/miro-ai --list                # List available skills
npx skills add miroapp/miro-ai --skill=miro-browse   # Install specific skill

Available skills: miro-browse, miro-code-review, miro-code-spec, miro-diagram, miro-doc, miro-table

See Agent Skills Overview | agentskills.io

</details> <details> <summary><strong>Other MCP Clients</strong> (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)</summary>

Add to your MCP client configuration file:

{
  "mcpServers": {
    "miro": {
      "url": "https://mcp.miro.com/"
    }
  }
}

Note: If a Miro plugin or extension becomes available for your client later, switch to it and remove the manual entry to avoid duplicate servers.

See MCP Setup Guide for client-specific paths.

</details>

Step 3: Authenticate

When you first use a Miro command, you'll be prompted to authenticate:

1. A browser window opens with Miro OAuth
2. Log in to your Miro account
3. Grant access to the requested boards
4. Return to your AI tool—you're connected!

Step 4: Try It

Test your setup with these example prompts:

"What's on my Miro board https://miro.com/app/board/..."

"Create a flowchart on Miro showing a user login flow"

"Summarize the architecture diagram on my Miro board"

Developer Mode

Want to modify plugins, test changes locally, or build your own? See CONTRIBUTING.md for dev setup instructions.

Codex plugins are generated locally into codex-plugins/*/ with the repo marketplace at .agents/plugins/marketplace.json. See Codex Plugins for the generated structure and CONTRIBUTING.md for regeneration and local testing.

Avoiding Duplicate Servers

If your client has a Miro plugin or extension, use only that — do not also add https://mcp.miro.com/ manually. Each installation method creates an independent MCP connection with its own OAuth session, and running more than one causes duplicate tools and auth confusion.

See the Duplicate MCP Servers guide in Miro's Developer docs for diagnosis and cleanup steps.

---

Enterprise Users

Admin Approval Required: If your organization is on a Miro Enterprise plan, your admin must enable the MCP Server before you can connect.

See Enterprise Guide for setup instructions.

---

What Can You Do?

Skills (Claude Code)

Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.

Skill	Triggers On
miro-browse	"List the frames on …", "What's on this board …"
miro-code-review	"Review PR 123 on …", "Visual review of this branch on …"
miro-code-spec	"Extract specs from …", "Pull the design docs at …"
miro-diagram	"Create a flowchart on …", "Add a sequence diagram to …"
miro-doc	"Add a markdown doc to …", "Write a sprint plan on …"
miro-table	"Make a task tracker table on …", "Sync these rows to …"

Capabilities (All Platforms)

Capability	Description
Generate Diagrams	Create flowcharts, sequence diagrams, ERDs from code or descriptions
Generate Code	Convert board designs and wireframes into working code
Track Tasks	Sync tasks between AI conversations and Miro tables
Extract Context	Read board content to inform AI workflows

---

Available Plugins

Claude Code

Plugin	Description
miro	Core MCP integration with 7 bundled skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table)

Gemini CLI

Extension	Description
miro	Core MCP integration with bundled skills

Codex

Plugin	Description
miro	Core MCP integration with native $miro:<skill> activation and MCP access

Agent Skills

Skill	Description
miro-browse	List, filter, summarize items on a Miro board
miro-code-review	Visual code review from PRs, local changes, or branch comparisons
miro-code-spec	Extract Miro specs (docs, diagrams, prototypes, tables, images) to .miro/specs/
miro-diagram	Create diagrams (flowchart, mindmap, UML, ER) from text or Mermaid
miro-doc	Create and edit markdown documents on a Miro board
miro-table	Create, populate, and sync structured tables on a Miro board

Kiro

Power	Description
code-gen	Design-to-code workflows

---

Security

• OAuth 2.1 secure authorization
• Enterprise compliance standards
• Permission-based access via your Miro account
• Rate limited API protection

---

Documentation

Getting Started

• MCP Setup Guide — Client-specific configuration
• Enterprise Guide — Admin setup for enterprise

Platform Guides

• Claude Code Plugins
• Gemini CLI Extension
• Cursor Plugins
• Agent Skills
• Kiro Powers

Reference

• MCP Tools Reference
• MCP Tutorials
• Troubleshooting

Development

• Plugin Development Guide
• Power Development Guide
• Validation
• Contributing

External

• Miro Developer Docs

---

Supported MCP Clients

Claude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex

---

Feedback & Support

• Issues & Features: Open an issue
• Feedback: Share your feedback
• Community: Miro Developer Community

---

License

MIT — see LICENSE

---

Built with love by Miro