Connecting to Miro's MCP Server

📘

This is a beta release of our MCP.

It is intended for evaluation and feedback purposes. The feature set and user experience may change in future releases. Feedback form.

This guide walks you through connecting Miro's MCP Server to MCP-compatible clients.

Prerequisites

❗️

If you are on Miro Enterprise Plan, you'll need to first enable Miro's MCP Server for your org before you can use it. See our Admin guide for more details.

Before you begin, ensure that:

• You are using a tool with MCP client capabilities.
• You have appropriate access permissions to your Miro workspace.
• Your tool is updated to support OAuth 2.1 authentication.

Configuration steps

1. Open your MCP-compatible client's settings.
2. Navigate to the MCP configuration section.
3. Add one of the following configurations based on your MCP client's capabilities:

For MCP clients with direct connection support:

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

After adding in this configuration, click on "Connect".

Miro OAuth Flow

This will start the OAuth flow in Miro.

Installing Miro MCP: Team Selection

📘

Miro MCP Server is team-specific. Please select the team that contains the board you wish to use. If you receive an access error later, simply re-authenticate and ensure the correct team is selected.

You'll see a note that the Authentication was successful, and you'll be redirected back into Cursor or your AI tool of choice.

You should see that the MCP Server is enabled and should see that tools and prompts are available, as shown below.

That's it! You can start prompting away! See our tutorials for more details on how to best use Miro's MCP Server.

Security and rate Limits

• Authentication uses OAuth 2.1 with dynamic client registration.
• Standard API rate limits apply to all operations.
• Enterprise security compliance is maintained.
• Access is governed by user permissions.

Troubleshooting issues

If you're experiencing connection issues, try these solutions:

1. Check MCP client support: Verify your AI tool supports MCP clients and can connect to MCP servers. Supported tools include Cursor, Lovable, and GitHub Copilot.

2. Verify remote server support: Some AI tools have MCP clients but don't support remote connections. For these cases:

   • Check your tool's documentation for remote connection support.
   • Ensure you're using the latest version of your AI tool.
   • Verify your network can reach the MCP server.

3. Use MCP Inspector: For detailed connection diagnostics, use MCP Inspector.

4. Request MCP support: If your AI tool doesn't support MCP, contact the tool's developers to request MCP server connection support.