Miro MCP Server
Connect AI agents to your Miro boards — create diagrams, docs, tables, and sticky notes on the canvas.
Updated
What is Miro MCP?
The Miro MCP server is a Model Context Protocol server that connects AI agents and coding tools directly to your Miro boards, the visual collaboration whiteboard for sticky notes, frames, diagrams, and tables.
Hosted by Miro at https://mcp.miro.com/, it gives an MCP-compatible client (Claude, Claude Code, Cursor, GitHub Copilot, and others) a secure gateway to read, search, and summarize board content, then create structured layouts — frames, sticky notes, shapes, text, cards, docs, tables, and diagrams (flowchart, mindmap, UML, ER). It can also read and resolve comments to turn team discussion into next steps on the canvas.
Authentication uses the Miro OAuth flow, so the agent acts on your behalf within the Miro team you authorize — no API keys to copy or rotate. The server is remote and managed by Miro, so there is nothing to self-host or run locally.
Tools the Miro MCP server exposes
| Tool | What it does |
|---|---|
| miro-browse | List, filter, and summarize items on a Miro board. |
| 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 board. |
| miro-code-review | Visual code review from PRs, local changes, or branch comparisons. |
| miro-code-spec | Extract Miro specs — docs, diagrams, prototypes, tables, and images. |
| miro-code-explain-on-board | Explain code visually on a Miro board. |
Connect the Miro MCP server
Claude Code
- 1
Add the Miro MCP server
Run: claude mcp add --transport http miro https://mcp.miro.com
- 2
Authenticate
Run /mcp (or /mcp auth) and complete the Miro OAuth flow in your browser to authorize your Miro team.
- 3
Verify
Run /mcp to confirm the miro server is connected, then ask the agent to summarize or create content on a board.
Alternatively, type 'plugins' in Claude Code, install the Miro plugin, then run /mcp to authenticate.
Cursor
- 1
Open MCP settings
Go to Cursor Settings -> MCP -> Add new MCP server.
- 2
Add the server config
Add: {"mcpServers":{"miro-mcp":{"url":"https://mcp.miro.com/"}}}
- 3
Authenticate
Click authenticate to start the Miro OAuth flow and authorize access to your Miro team.
You can also install the Miro plugin from the Cursor marketplace via 'Add to Cursor'.
Sample use cases
An agent generates an architecture or sequence diagram on a Miro board when a pull request opens.
Reviewers see a visual model of the change without drawing it by hand.
A scheduled agent turns meeting notes into a structured Miro doc or table.
Discussions become clear, shareable artifacts on the canvas.
An agent reads and resolves board comments, summarizing them into next steps.
Team feedback is triaged into actionable items automatically.
Security & permissions
The Miro MCP server authenticates via the Miro OAuth flow (OAuth 2.1). Instead of static API keys, the agent receives a scoped token tied to the Miro team you authorize, and it acts on your behalf within that team — meaning it can read, search, and create board content according to the permissions you grant.
On Enterprise plans, an organization admin must enable the MCP Server before any user can connect, giving central control over access. Revoke access at any time from your Miro account's connected-apps settings.
Using Miro MCP with Gamut
In a Gamut workflow, Miro is added as a connected tool and Gamut manages the OAuth connection, so an agent can act on your boards without you handling tokens. An event- or schedule-triggered agent can then turn upstream signals into visual artifacts — for example, generating an architecture or ER diagram on a board when a pull request opens, drafting a Miro doc from meeting notes on a daily schedule, or populating a table from a data source — running unattended within the scope you authorized.
Frequently asked questions
What is the Miro MCP server?
It is an officially hosted Model Context Protocol server, at https://mcp.miro.com/, that connects AI agents and coding tools to your Miro boards so they can read, search, summarize, and create content like sticky notes, frames, diagrams, docs, and tables.
Is the Miro MCP server free?
The MCP server is available across Miro plans, including the Free plan (3 active boards). Higher tiers add more boards and features, and on Enterprise plans an admin must enable the MCP Server first. Some AI-powered actions may use Miro AI credits.
How do I connect the Miro MCP server to Claude Code or Cursor?
In Claude Code, run 'claude mcp add --transport http miro https://mcp.miro.com' then '/mcp' to complete the Miro OAuth flow. In Cursor, add {"mcpServers":{"miro-mcp":{"url":"https://mcp.miro.com/"}}} under Settings -> MCP and click authenticate.
Is the Miro MCP server hosted or self-hosted?
It is officially hosted and maintained by Miro at https://mcp.miro.com/. There is nothing to self-host or run locally — you connect over HTTP and authenticate with OAuth.