If you see this error during the auth process, please clear your Miro browser cookies.
Open Developer Tools in Google Chrome or browser of choice: Chrome -> View -> Developer Tools -> Application -> Cookies -> Miro.com -> (Right Click) and Clear
š Authentication & Team Access
The most common issues with the Miro MCP server relate to how users are authenticated across multiple teams.
Why am I seeing a "Different Team" authorization error?
If you receive the following error message:
"This board belongs to a different team than your current authorization. To access this board, please re-authorize while viewing it."
āļø
The "Last One Wins" Rule: This 1:1 rule applies across all MCP Clients. If you authenticate into a new team or even a different MCP Client, the previous connection is immediately dropped.
The Cause: Miro MCP maintains a 1:1 connection. Each individual user can only be "connected" or "authed" into one team at a time. This is true even if you auth with multiple MCP Clients. For example, if you auth into 3 clients, only the latest client connection will work!
The Behavior: Once a user re-authenticates into another team, the connection from the previous team is lost. If the AI tries to access a board from a team that is no longer authenticated, it will trigger this error.
The Fix: Simply re-authenticate while viewing a board in the desired team to reset the connection to that specific environment.
š Duplicate MCP Servers
Why am I seeing duplicate Miro tools or repeated auth prompts?
There are multiple ways to install the Miro MCP Server, and each creates an independent connection with its own OAuth session. If more than one is active in the same client, you'll see duplicate tools and authentication confusion.
Clients without a Miro plugin (VSCode + Copilot, Windsurf, Lovable, etc.)
User or project
āļø
The rule: use only one method per client. If your client has a Miro plugin or extension, use that ā and do not also add manual MCP config. They both connect to the same server but maintain separate auth sessions.
How to fix duplicates
Check your MCP server list in your client's settings. If you see more than one Miro entry, you have duplicates.
If you have a plugin installed ā remove the manual config entry. The plugin already manages the MCP connection for you.
Restart your client and re-authenticate once.
How to Solve "Board Access denied" error in VSCode
Go to bottom left corner, click on profile icon -> MCP (mcp.miro.com) -> Sign out (As shown below).
Sign out of the Miro MCP Server.
Follow the steps to re-add the Miro MCP Server to VSCode. Easiest way is by clicking install from the GitHub MCP Registry.
Re-run your prompt and you should see that the error is gone.
š» Client Not Registered Error
If you see a "Client Not Registered" error with VSCode (or other MCP Clients) during auth, specifically this error:
How to Solve Client Not Registered Error Request
You will need to re-request a new Client ID from the MCP Server.
VSCode Client Not Registered Solution
For VSCode, you can run the following command
Go to command pallet by going to Code -> View -> Command Pallete (as shown below)
Use the following command: Authentication: Remove Dynamic Authentication Providers
That's it! Re-auth, and the issue should be fixed.
Cursor Client Not Registered Solution
For Cursor, you can run the following commands
Go to command pallet by going to Cursor -> View -> Command Pallete (as shown below)
Open the Command Palette from Cursor Settings
Use the following command: Cursor: Clear all MCP Tokens
We need to clear MCP Tokens in order to re-request a new Client ID
Re auth into Cursor by going into MCP Settings -> Connect.
You should see the Miro App Request from Cursor and click on Allow Access.
Access request for Miro's MCP Server
You will now go through the OAuth flow to select a team to install the MCP Server on within your Miro Organization.
That's it! You should see the tools are available in the Cursor MCP Settings.
š¢ Enterprise & Admin Setup
Is MCP available across all teams in an Enterprise account?
No. MCP must be enabled on a team-by-team basis.
Admin Action: Enterprise admins can turn the feature on/off at the Org-level, but they must explicitly select the teams where it should be active. If you're on an Enterprise account, ensure your admin has turned it on - see guide here.
User Access: If you cannot find the MCP in your sidebar, please contact your Admin to ensure your specific team has been enabled in the settings.
ā” Quick Troubleshooting Guide
Issue
Resolution
"Board not found"
Ensure the board belongs to the team you are currently authenticated into.
Connection Lost
This usually happens when you auth into a second team. You must re-auth to switch back.
Permissions Error
Verify that the user who performed the OAuth flow has at least View access to the board.
Duplicate tools
You have multiple Miro MCP servers active (e.g., plugin + manual config). Keep only one ā see Duplicate MCP Servers section above.
