# Miro MCP

> Lets your agent read, summarize and build your Miro boards: sticky notes, diagrams, docs, tables and comments.

Miro's own MCP server connects your agent to your Miro boards. It can search and summarize what's on a board, build boards for workshops, draw flowcharts and technical diagrams, and read and resolve comments. It reads a board as SVG and writes changes back the same way, so it can change one frame without touching the rest.

What you can do with it
- Summarize a board, or cluster a research wall's sticky notes into themes
- Build boards for retros, sprint planning and strategy sessions, with frames, sticky notes, shapes, cards, docs and tables
- Draw flowcharts, architecture, sequence, UML class and ERD diagrams from a description, your code or a pull request
- Create docs, tables, timelines and kanban boards, and add images from public URLs
- Read, reply to and resolve comments, and turn the discussion into next steps
- Create prototypes from HTML screens, and read the screens of existing ones
- Search your boards and create new ones

How it connects
Miro hosts it at https://mcp.miro.com/. The first time your agent uses it, you sign in to Miro with OAuth and pick the team whose boards it can use. It only sees boards you can already open, and your board permissions still apply. In Gemini CLI it installs as an extension (gemini extensions install https://github.com/miroapp/miro-ai), which also brings Miro's skills.

Good to know
- It works on every Miro plan, including Free. Each plan has a daily allowance of tool calls; past it, calls are refused until the limit resets at 00:00 UTC.
- On Enterprise plans an admin has to turn it on first, under Admin settings, Apps & Integrations, MCP.
- It's connected to one team at a time. To use boards in another team, sign in again while viewing a board in that team.
- Put the full board URL in your ask so it finds the right board.

- Type: Plugin
- Made by: Miro
- Category: Design
- Formats: Remote MCP, Extensions
- Version: 2.0.0
- Website: https://developers.miro.com/docs/miro-mcp
- Source: https://github.com/miroapp/miro-ai
- Page: https://pluginboard.ai/plugins/miro-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.miro.com/ under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.miro.com/

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.miro.com/. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.miro.com/". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.miro.com/

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.miro.com/ and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22miro-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.miro.com%2F%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http miro-mcp https://mcp.miro.com/
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=miro-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5taXJvLmNvbS8ifQ%3D%3D

Add to .cursor/mcp.json:

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

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http miro-mcp https://mcp.miro.com/
```

### Codex

Run in your terminal:

```shell
codex mcp add miro-mcp --url https://mcp.miro.com/
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

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

### Gemini CLI

Run in your terminal:

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

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.miro.com/ (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add miro-mcp --url https://mcp.miro.com/ --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.miro.com/, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login miro-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add miro-mcp --url https://mcp.miro.com/
```

If it needs a key: For https://mcp.miro.com/, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add miro-mcp --url https://mcp.miro.com/
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "miro-mcp": {
      "url": "https://mcp.miro.com/"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.miro.com/ asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).