Connecting Miro's MCP Server to MCP Clients

This page shows examples of how to connect to Miro's MCP Server to other AI Tools.

For connecting with Claude, Claude Code, Codex and ChatGPT, Cursor, Gemini CLI, or VS Code, see our get started section.

GitHub Agents

1. Go to https://github.com/apps/miro and click on install.

2. Choose the org you want to install the app into.

3. Select the repo's you'd like to use the Miro MCP Server functionality with. Then click on install and authorize.

4. Auth into the Miro team you'd like to use the MCP Server with.

5. Go to the repo you'd like to use the agent with, and click on the Agents tab. Choose the Miro agent.

   

6. Try it out! You can ask the agent to:
   "Visualize this PR [paste in PR link] on a new Miro board".

Lovable

1. Log into lovable.dev.
2. Click on your profile in the top right.
3. Click on Settings -> Integrations. Scroll down to Your MCP Servers and find Miro. Click Set up.

4. Click on Connect and then follow the Miro OAuth flow to install Miro's MCP Server on the team of your choice. You'll only be able to use MCP on boards from the team you authorize.

🎉 That's it! You've now connected Miro's MCP Server to Lovable!

Replit

1. Click on button below to install Miro's MCP Server in Replit.

2. Click on Test & Save.

3. Click on Authorize with OAuth. This will start the OAuth flow to authenticate into your Miro account. Select the Miro Team where you want to use MCP. See Miro OAuth flow for MCP for more details.

4. Now you can start using your content inside Miro to build prototypes in Replit, just make sure to include the board ID you want to reference in your prompt!

Windsurf

1. Go to Windsurf settings -> Windsurf Settings -> Cascade -> Manage MCPs -> Configure and then add in the following JSON:

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

2. Go through the Miro OAuth flow and add the MCP app on the team of your choice.
3. Start prompting Windsurf to use Miro MCP, we recommend code_create_from_boardadd in a board URL like https://miro.com/app/board/uX1234567/ and hit enter.

Kiro IDE

1. Find the Miro Kiro Power, as shown below, and click on "Open in Kiro".

2. Click on "Install".

3. Click on "Try Power".

4. That's it! When you click on "Try Power" the agent should tell you the next steps. You can drop in a Miro board URL to analyze your board, or generate docs, tables, diagrams, and more coming soon!

If you don't want to install Miro MCP via the Kiro Power, you can still install it manually, although we recommend using the Power.

Go to Workspace settings and then search for "MCP" in the search bar.

1. Open Workspace Config for MCP, this should open an mcp.json file.
2. Add in the following JSON and save it:

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

5. You'll be asked to first allow the Kiro app, and then once you click allow you'll be asked to auth into Miro by following the Miro OAuth flow. Add the MCP app on the team of your choice that you wish to use MCP with.
6. Try this prompt: "Summarize the content on this board": [your-board-URL] OR "create me a sequence diagram of the data flow for [enter app of your choice] and add it to this board [your-board-URL]

Kiro CLI

1. After you install Kiro CLI, ensure your MCP Config file looks like this:

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

2. Go through the Miro OAuth flow and add the MCP app on the team of your choice.
3. Start prompting Kiro CLI to use Miro MCP, we recommend code_explain_on_boardadd in a board URL like https://miro.com/app/board/uX1234567/ and hit enter.

Amazon Q IDE Extension

Read more about Amazon Q IDE Extension here.

1. After you install the extension, ensure your configuration looks like this (ensure Transport is http and the url is https://mcp.miro.com. Then hit save.

After that, you are ready to start prompting!