Miro MCP Server Cursor IDE Setup 2026

How do you set up the Miro MCP server in Cursor? Add a url-type entry pointing at https://mcp.miro.com/ to mcp.json, then complete Miro's OAuth flow and select the team you want to connect — there's no API key to generate. Once connected, Cursor can read board content (frames, diagrams, sticky notes, tables) and create or update boards directly from chat, which matters if your team keeps architecture diagrams, planning boards, or retro notes in Miro instead of a docs tool.

Miro's MCP server is team-specific — the OAuth grant you approve applies to one team's boards, not your whole Miro account. If you work across multiple teams, that's the first thing worth understanding before you connect.

What the Miro MCP Server Enables

Once connected, Cursor can:

This is genuinely different from most integrations on this site: Miro boards are visual and loosely structured, so the value here is less "CRUD against an API" and more "let the AI actually look at the diagram your team drew instead of guessing at what it says."

Prerequisites

Step 1: Add the Server to mcp.json

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

There's no command, args, or env block — this is a remote, OAuth-authenticated server, not a locally-spawned process.

Step 2: Complete the OAuth Flow

1. In Cursor, connect to the miro-mcp entry (or restart Cursor if it doesn't prompt automatically)
2. A browser window opens for Miro authentication — sign in if you aren't already
3. Select the team you want Miro MCP connected to — this is required, and it scopes everything the server can see
4. Click Add
5. You'll see a success confirmation and get redirected back to Cursor

If you need access to boards across more than one team, you'll need to either re-authenticate and switch teams when you need the other one, or check whether your Miro plan supports connecting multiple team-scoped entries under different server names in mcp.json.

Step 3: Verify the Connection

In Cursor chat, try:

List the boards in my connected Miro team

Or, if you already know a specific board:

Summarize the content of the "Q3 System Architecture" board in Miro

A response describing real frames, shapes, or sticky notes confirms the connection is live.

Practical Workflows

Pull architecture context before coding

Find the "Payments Service Architecture" board in Miro, read the diagram, and summarize the components and their connections before I start implementing the webhook handler

Turn a planning board into tickets

Read the "Sprint 14 Planning" board and list every sticky note in the "This Sprint" frame as a plain checklist I can turn into tickets

Cross-reference a diagram against actual code

Compare the service boundaries shown in the "System Overview" Miro board against the folder structure in /src — flag anything that doesn't match

Generate a diagram from a conversation

Based on the auth flow we just discussed, create a simple flow diagram on the "Auth Redesign" board in Miro showing each step

Troubleshooting

OAuth flow completes but Cursor shows no boards
Almost always a team-selection mismatch — you authenticated against a different team than the one containing the boards you're looking for. Re-authenticate and double-check the team picker during the OAuth step.

"Access denied" on an Enterprise Miro plan
Enterprise orgs can restrict MCP access at the admin level. If individual OAuth completes but every tool call fails, check with your Miro org admin whether MCP access is enabled for your team — this is an org policy setting, not something fixable from mcp.json.

Board content looks incomplete or outdated
The server reads board state at query time, not a cached snapshot — if a board looks stale, it's more likely a large or complex board where certain widget types (deeply nested frames, some third-party board plugins) didn't get fully captured by the read tool. Ask Cursor to focus on one frame at a time rather than the whole board for complex layouts.

MCP entry doesn't appear in Cursor's connection list
Confirm the url field is exactly https://mcp.miro.com/ with the trailing slash — remote MCP entries in Cursor are sensitive to malformed URLs in a way that local command-based entries aren't.

When This Doesn't Make Sense

If your team's Miro usage is mostly freeform brainstorming with no consistent structure (no frames, no naming conventions, sticky notes scattered with no grouping), the AI's board summaries will be noisy — it can only work with what's actually organized on the canvas. This integration pays off most on boards that already follow some structure: named frames, one topic per section. For genuinely chaotic boards, a human skim is still faster than an AI summary.

Frequently Asked Questions

Q: Do I need an API key to set up Miro MCP?
A: No. Miro's official MCP server uses OAuth 2.1 — you authenticate through a browser flow and select your team, and there's no token to generate or paste into mcp.json.

Q: Can Cursor see boards across all my Miro teams at once?
A: No — the OAuth grant is team-specific. You select one team during setup, and the connection is scoped to that team's boards. Accessing a second team requires re-authenticating or configuring a separate connection.

Q: Can the AI create new boards and diagrams, not just read existing ones?
A: Yes. The server supports creating and updating boards, diagrams, documents, tables, and code widgets, in addition to reading existing content.

Q: Does this work on Miro's free plan?
A: The MCP server itself works on standard plans with basic access to boards in your selected team. Enterprise plans add admin-level controls over MCP access org-wide, which some orgs use to restrict or gate the integration — check with your admin if a standard OAuth flow gets blocked.

Q: Is there a security risk to connecting an AI to boards that might contain sensitive planning info?
A: Same consideration as any MCP integration with read access to internal content — the AI can see whatever your authenticated Miro identity can see. Don't connect a personal account with access to boards outside what you want a given coding session to reference; use a team-scoped connection deliberately rather than a broad one.

Related Guides

---