# Connect the Miro MCP server to Unblocked to give AI agents live board and diagram context URL: https://getunblocked.com/integrations/miro/ Unblocked connects to Miro’s MCP server so AI coding agents can read your boards, diagrams, docs, and comments live — then its Context Engine reconciles what they find with the code, pull requests, and conversations behind it. --- ## Miro integration details - **Category:** Documentation - **Live-queried data:** boards, diagrams - **Supported products:** Miro boards · Miro diagrams · Miro docs · Miro comments - **Works with:** Claude Code, Cursor, Devin, GitHub Copilot, Codex, OpenCode, VS Code — via one MCP server connection - **Maintained by:** Miro · verified by Unblocked - **Content reviewed:** October 20, 2026 - **Website:** ## What the Miro integration adds Architecture sketches, sequence diagrams, and planning boards often live in Miro, far from the code they describe. An agent working in the editor can’t see the board where the team drew the service boundaries or left review comments on a flow, so it builds without the design behind the task. Miro’s MCP server exposes boards to AI agents, and Unblocked connects to it once so every agent can read them without its own Miro setup. This is a third-party MCP server: Miro hosts and maintains it, and Unblocked connects to it as a verified MCP server. Nothing is ingested or indexed — Unblocked calls the read-only tools you select at the moment a question needs them, so answers reflect your boards as they are now, within the board permissions of the account that authorized the connection. Wiring Miro’s MCP server straight into an agent gives it board items and text. Unblocked’s Context Engine reasons across those results and your other sources — following a frame in an architecture diagram to the pull request that implemented it, the ticket that scoped it, and the Slack thread where the design changed — and returns one cited answer. Once connected, any MCP-compatible coding agent — Claude Code, Cursor, Devin, GitHub Copilot, Codex — reaches Miro context through a single Unblocked MCP server connection. ### What you get - **Live boards, diagrams, and docs** — Agents read frames, diagrams, docs, tables, and comments as they are on the board right now, through Miro’s own MCP server rather than an exported snapshot. - **One connection for every agent** — Connect Miro to Unblocked once. Claude Code, Cursor, Codex, and GitHub Copilot reach it through the Unblocked MCP server, with no per-agent Miro configuration. - **Read-only, board-safe control** — Only read-only tools are offered, so agents can’t create items, edit docs, or resolve comments on your boards. Choose which tools Unblocked may call from Settings → Data Sources. - **Context Engine reasoning** — Miro results are reconciled with your code, pull requests, tickets, and conversations, so a diagram on a board leads to the implementation and the decisions behind it — with citations. ## How to connect Miro to Unblocked Prerequisites: - An Unblocked account (free to start). - A Miro account with access to the boards you want to query and permission to authorize an OAuth app; on Enterprise plans, an admin must first enable the Miro MCP server for the organization. - An MCP-compatible coding agent (Claude Code, Cursor, Devin, etc.) to use the context in your editor. ### Step 1: Connect Miro to Unblocked 1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Documentation select Miro. 2. The Miro MCP server URL is filled in for you. Choose OAuth, click Connect, and sign in to Miro to authorize Unblocked. 3. Once Unblocked discovers the server’s tools, select the read-only tools it may use and click Save Settings. ### Step 2: Install the Unblocked MCP server On macOS or Linux, one command auto-detects and configures the supported agents on your machine: ```bash curl -fsSL https://getunblocked.com/install-mcp.sh | bash ``` On Windows, or when you prefer remote MCP, add the server manually using the configuration below or follow the manual install guide: Claude Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth: ```bash claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse ``` Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth: ```json { "mcpServers": { "unblocked": { "url": "https://getunblocked.com/api/mcpsse" } } } ``` Any MCP-compatible client (Devin, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse` ## Miro MCP server tools Miro hosts and maintains this MCP server. Unblocked calls only the read-only tools you select, at the moment a question needs them: - **`board_search_boards`** — Searches and lists the Miro boards the connected account can access. - **`context_explore`** — Surveys a board’s high-level items — frames, docs, tables, and diagrams — so a question can target the right part of the board. - **`context_get`** — Returns text context from a whole board or a single item. Calls to this tool use Miro AI credits. - **`board_list_items`** — Lists the items on a board, with cursor-based pagination and optional filters. - **`layout_read`** — Reads existing board items and returns them as Miro’s layout DSL text. - **`comment_list_comments`** — Lists the comments on a board or on a specific item. ## Connect Miro to Claude Code, Cursor, and other AI agents To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Miro context, connect Miro to Unblocked and add the single Unblocked MCP server to your agent. Unblocked acts as the MCP context layer for your Miro data, searching boards and diagrams alongside your other connected sources and returning cited results through these tools: - **`context_research`** — Researches a question across your connected sources and calls the Miro tools you selected when boards, diagrams, or board comments are relevant, returning a synthesized answer with citations. - **`context_get_urls`** — Fetches the full content behind URLs your agent encounters across connected sources — Jira, Linear, Notion, Confluence, Slack, GitHub, and more. ## Questions to ask an AI agent about Miro Questions you (or your agent) can ask Unblocked about your Miro data: - "Does the payments service match the architecture diagram on our platform Miro board, and which pull requests diverged from it?" - "What open comments are on the checkout flow board, and is there a ticket tracking each one?" - "Summarize the sequence diagram for the auth handshake and point me to the code that implements it." - "Which services on the migration planning board have shipped, and what did the team say in Slack about the ones that haven’t?" ## Miro integration FAQ ### What is the Miro MCP server? The Miro MCP server is a remote Model Context Protocol server, hosted and maintained by Miro, that lets AI agents work with Miro boards — searching boards, listing items, and reading the text of frames, diagrams, docs, tables, and comments. Unblocked connects to it as a verified MCP server, so every agent reaches it through one Unblocked connection. ### Can Unblocked add or change items on my Miro boards? No. Miro’s MCP server also offers tools that create boards, diagrams, docs, and tables, edit items, and reply to or resolve comments, but Unblocked excludes every tool that might modify data. Only read-only tools such as board search, item listing, and comment listing are available for selection. ### Which Miro boards can agents read through Unblocked? Agents can read the boards the authorizing Miro account can access. Miro’s MCP server respects existing board permissions and access controls, so a board that account can’t open stays out of reach. ### Do I need a Miro admin to connect the MCP server? On Miro Enterprise plans, the MCP server is disabled by default, so an admin must enable it for the organization before anyone can authorize a connection. Once it’s enabled, connecting uses Miro’s OAuth sign-in. ### Does Unblocked copy my Miro boards into an index? No. Nothing from Miro is ingested or indexed. Unblocked calls Miro’s tools while it answers a question, so a diagram edited this morning is read as it stands now. ## Related integrations - [Lucid](https://getunblocked.com/integrations/lucid/) — Diagrams and visual documentation from Lucid’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed. - [IcePanel](https://getunblocked.com/integrations/icepanel/) — Architecture diagrams from IcePanel’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed. - [Confluence](https://getunblocked.com/integrations/confluence/) — Pages and blog posts from the Confluence spaces you select — including rendered macro content — indexed and cited in answers. - [Jira](https://getunblocked.com/integrations/jira/) — Issues and projects from Jira Cloud and Data Center — with sprint-aware answers that connect tickets to the code and PRs behind them. ## Get started with Unblocked - Start a free trial: - Pricing: - All integrations: