> 👍 Feedback [form](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx). This guide shows examples of how to connect to Miro's MCP Server based on the MCP-compatible client you are planning to work with. The [Miro OAuth flow](https://developers.miro.com/docs/connecting-to-miro-mcp#miro-oauth-flow) will be the same, but each tool may have a slightly different UI. > 📘 The UI of each MCP-compatible client on this page may have changed recently, so please use this as a general guide. For the most accurate information, see the documentation of the MCP-compatible client of your choice. > ❗️ 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](https://help.miro.com/hc/en-us/articles/31625761037202-Miro-MCP-Server-admin-guide) for more details.
## Claude (Web & Desktop App) Use this method to connect Miro to your standard Claude chat interface. This works across the Claude web app and the Claude Desktop application. **Setup Steps** 1. **Open Connectors:** In the Claude chat box, click the plus (+) icon and select Add connectors.

2. **Find Miro:** Select the **Web tab** and search for "Miro."

3. **Connect:** Click the plus (+) icon on the Miro card, then click Connect on the following screen.

4. **Authorize:** Follow the Miro OAuth flow to authorize the app for your specific Miro team. 5. **Verify:** You will see a "Connected to Miro" confirmation. You can now prompt Claude to access or create content on your boards by including a board URL in your message.

6. 💡 Try this prompt: "Summarize the content on this board": \[your-board-URL] OR "create me a sequence diagram of the data flow for Claude Web and Desktop app, and add it to this board \[your-board-URL] ## Claude Code For most up to date info on how to manage MCP Servers with Claude Code, go to [Claude Code MCP Docs](https://code.claude.com/docs/en/mcp). 1. Login to Claude Code and type in `plugins`

2. From the plugin menu, search for `Miro`

3. Install the plugin 4. Type in `/mcp` and you should see the Miro MCP. Auth into it, and you should be able to use it!
> 📘 Manual config > > We recommend users to use the plugin instructions above. 1. Login to Claude Code with `claude` command. 2. Next, use `claude mcp add --transport http miro https://mcp.miro.com` to add the Miro MCP into Claude Code. 3. Use `/mcp auth` and then auth into Miro by following the [Miro OAuth flow](https://developers.miro.com/docs/connecting-to-miro-mcp#miro-oauth-flow). 4. Once you've authed, you are ready to use Miro's MCP Server. From there, type in a prompt such as \`create me a new Miro board that visualizes my codebase from this directory \[add in path to your code] as an architecture diagram ## Cursor For Cursor, the best way to install the MCP Server is to go to [Cursor's Marketplace and find the Miro Plugin](https://cursor.com/marketplace/miro).
From there, click on "View in Editor".

Then, find the Miro Plugin and click on it.

Lastly, click on "Add to Cursor" and from there, if you should see that the Plugin is installed as shown below.

That's it! Now you can prompt cursor to read your Miro boards and generate docs, diagrams, tables, and more to come soon!

Alternatively, if you want to install the MCP Server manually, you can go to Cursor settings -> Cursor Settings -> MCP -> Add a Custom MCP Server and add in the following JSON: ```json mcp.json { "mcpServers": { "miro-mcp": { "url": "https://mcp.miro.com/", "disabled": false, "autoApprove": [] } } } ``` Click on the authenticate button. This should open a new window for the Miro OAuth flow (see below). See [OAuth details in previous guide](https://developers.miro.com/docs/connecting-to-miro-mcp#miro-oauth-flow). You should see that the MCP Server is enabled and should see that tools and prompts are available, as shown below. You should see tools and prompts are now enabled via Miro's MCP Server!

You should see tools and prompts are now enabled via Miro's MCP Server!

That's it! You're ready to start generating diagrams and next level apps with Miro MCP! ## VSCode and GitHub Copilot Use this method to connect Miro to VSCode + GitHub Copilot. **Setup Steps** 1. Find Miro's MCP Server on [GitHub's MCP Registry](https://github.com/mcp/miroapp/mcp-server). 2. Click on "Install MCP server".

3. Open the [Miro OAuth flow](https://developers.miro.com/docs/connecting-to-miro-mcp#miro-oauth-flow), install the app on the team of your choice. 4. That's it! You can now start using Copilot agent to visualize on Miro, create code from context on Miro boards, or summarize boards. 5. 💡 Try this prompt: "Summarize the content on this board": \[your-board-URL] OR "create me a sequence diagram of the data flow for VSCode app and it's extensions and add it to this board \[your-board-URL] 6. To use Miro's MCP Server's built in [prompts](https://developers.miro.com/docs/miro-mcp-prompts#prompts) you can type in `/` and you should see the prompts which Miro's MCP Server provides. To see Miro's MCP Server tools, click on the _tools_ icon and you should see Miro's tools.

To see Miro's MCP Server tools, click on the _tools_ icon and you should see Miro's tools.

9. See [tools](https://developers.miro.com/docs/miro-mcp-prompts#tools) that you have available. See tools that you have available. Always check [tools](https://developers.miro.com/docs/miro-mcp-prompts#tools) documentation for latest tools.

See tools that you have available. Always check [tools](https://developers.miro.com/docs/miro-mcp-prompts#tools) documentation for latest tools.

10. To ensure the Copilot Agent uses exactly the tools you want, you can _explicitly tell the agent to complete task X with tool Y_.
💡Try this prompt: "_use the create\_diagram tool to create me a diagram of my codebase at_ \~/dev/codebase \__and add it to this Miro board_ _\[add in your Miro board URL]"_ > ❗️ Ensure that the Miro board which you are referencing is in the team you've authed Miro MCP Server app into ## GitHub Agents 1. Go to [https://github.com/apps/miro](https://github.com/apps/miro "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](https://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](https://developers.miro.com/docs/connecting-to-miro-mcp#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! ❤️ Now you can start using your content inside Miro to build prototypes in Lovable, just make sure to include the board you want to reference in your prompt! ✨You can prompt it something like "build me a landing page based on the content of this board: \<[https://miro.com/app/board/](https://miro.com/app/board/)/> (**but add in your own Miro board URL**). ## Replit

> 📘 To use MCP with the [Miro board](https://miro.com/app/board/uXjVJh90oMA=/?share_link_id=56307974595) in the video, use [this template](https://miro.com/templates/miro-mcp-replit-digital-transformation/) to bring that same Miro board into your account. > > And the [REPL](https://replit.com/t/replit/repls/PrecisionInventory/view) from video above. 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](https://developers.miro.com/docs/connecting-to-miro-mcp#miro-oauth-flow) 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! ## 9. > ❗️ ## Gemini CLI Watch the video below: > 📘 We recommend installing via the [official extension](https://geminicli.com/extensions/?name=miroappmiro-ai) Once logged into Gemini CLI, simply type ```bash gemini extensions install https://github.com/miroapp/miro-ai ``` and then authenticate into the Miro team you want to use.

## Windsurf 1. Go to Windsurf settings -> Windsurf Settings -> Cascade -> Manage MCPs -> Configure and then add in the following JSON:
```json mcp.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_board`add in a board URL like [https://miro.com/app/board/uX1234567/](https://miro.com/app/board/uX1234567/) and hit enter.
## Kiro IDE 1. Find the [Miro Kiro Power](https://kiro.dev/launch/powers/miro-codegen/), 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. After searching for MCP settings, open either Workspace or User MCP Config

After searching for MCP settings, open either Workspace or User MCP Config

1. Open Workspace Config for MCP, this should open an `mcp.json` file. 2. Add in the following JSON and save it: ```json .kiro/settings/mcp.json { "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](https://developers.miro.com/docs/connecting-to-miro-mcp#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: ```json .kiro/settings/mcp.json { "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_board`add in a board URL like [https://miro.com/app/board/uX1234567/](https://miro.com/app/board/uX1234567/) and hit enter. ## Amazon Q IDE Extension Read more about Amazon Q IDE Extension [here](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE-setup.html). 1. After you install the extension, ensure your configuration looks like this (ensure **Transport is http** and the url is **[https://mcp.miro.com](https://mcp.miro.com)**. Then hit save.

After that, you are ready to start prompting!