PluginInstalls cleanly

Draw diagrams and docs on Miro boards

Miro AI

Miro's official plugin: your assistant can read what is on a Miro board and create flowcharts, documents and tables on it from a request in plain words.

Works with
Claude Code, Gemini CLI
Good for
Daily work and research, Graphic designers

What it does

Miro is an online whiteboard that teams use for workshops, plans and diagrams. This is Miro's own plugin. It connects your assistant to Miro's hosted connector at https://mcp.miro.com/ (an MCP server, which is a bridge that gives an assistant tools). With it, your assistant can read what is on a board and add flowcharts, documents, tables and sticky notes to it.

You do not need a special command to make content. Paste a board link and ask in plain words, for example "summarise this board" or "put these notes in a table". The connector's own tools do this work.

The plugin also adds three skills for code work. The repository has three, although the README still names eight:

  • miro-code-explain-on-board draws a codebase as a small set of diagrams plus a short document, so non-developers can follow it.
  • miro-code-review turns a pull request, local changes or a branch into a visual code review on a board.
  • miro-code-spec copies a board's documents, diagrams and tables into a .miro/specs/ folder in your project, so the assistant can plan from them.

When you sign in, Miro asks which boards to share. The assistant can only work on those boards. In September 2026 Miro removed its older board tools and replaced them with new "canvas" tools, so old guides may name tools that no longer exist.

Who it is for

Teams that plan, design or review work on Miro boards. It helps when you want the assistant to read a board, add diagrams and tables, or explain code to people who do not read code.

Example prompts

  • "What's on my Miro board https://miro.com/app/board/... ? Summarise it in five bullet points."
  • "Turn the meeting notes in notes.md into a table on this Miro board."
  • "Explain this codebase on my Miro board so our product manager can follow it."
  • "Create a visual code review of my current changes on this board."

How to install

/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-ai
gemini extensions install https://github.com/miroapp/miro-ai

How to use it

Ask: Create a flowchart on Miro showing our customer onboarding steps. Log in to Miro in the browser window that opens and choose which boards to share.

Other assistants

Gemini CLI: Miro publishes the same repository as a Gemini CLI extension. It includes the connector and the same three skills.

  1. Install the extension:
gemini extensions install https://github.com/miroapp/miro-ai
  1. Restart Gemini CLI. Sign in to Miro when it asks. If it does not ask, type /mcp auth miro.

Codex CLI: Miro lists Codex as a supported client but gives no install command. These commands follow the Codex MCP docs and add the connector without the skills.

  1. Add the connector:
codex mcp add miro --url https://mcp.miro.com/
  1. Sign in to Miro:
codex mcp login miro

Check it works

  1. Restart Claude Code after you install the plugin. The README asks for this.
  2. Type /mcp and complete the Miro sign-in in your browser. Choose only the boards you need.
  3. Paste a board link and ask what is on it. The assistant must answer with real items from that board.

The plugin is also in Anthropic's official marketplace as miro@claude-plugins-official.

Common problems

  • Miro tools appear twice or keep asking you to sign in — duplicate tools and repeated sign-in prompts — You have more than one Miro connection. Each connection has its own sign-in. Use only the plugin or extension, and remove any https://mcp.miro.com/ entry you added by hand. Miro's FAQ has a guide on duplicate servers.
  • Gemini CLI sign-in fails — Failed to discover OAuth configuration from MCP server — In GitHub issue #29 the cause was a VPN. Turn the VPN off and run /mcp auth miro again.
  • Sign-in stops after you allow access — Invalid or expired consent token — Issue #50 is still open. Miro's team suggested that the user clear all browser cookies for Miro and try again.
  • Miro says you are in a different team — an authorization error that names another team — Miro's FAQ says to sign in again while a board in the correct team is open.
  • Board tools you used before are gone — calls to old tools fail — Miro removed the old board tools in September 2026. Disconnect and reconnect the connector so the new canvas tools load. In issue #66 the new tools appeared after a reconnect.
  • miro@claude-plugins-official is not found — the install fails on a new computer or in a script — Claude Code adds the official marketplace only on the first interactive session. Run claude plugin marketplace add anthropics/claude-plugins-official first.

What to watch out for

  • Can read and add content on the boards you grant during sign-in; grant only the boards you need
  • Board content passes through Miro's hosted server (mcp.miro.com) to your AI model
  • On a Miro Enterprise plan an admin must turn on the MCP server first (README)
  • If you added the Miro server by hand before, remove that entry; the README warns that duplicate servers conflict
  • The README still lists eight bundled skills, but a 2026-09-16 commit removed five; the Claude plugin folder now has three code-focused skills, and diagrams, docs and tables come from the Miro connector
  • The miro-code-review skill adds board links to your pull request description, or posts a comment if it cannot edit it
  • A code review puts tables, summaries and a security review of your code on the board; everyone with board access can see them
  • The skill file says diagrams made with the canvas tools cannot be moved or deleted through those tools; remove them by hand in Miro
  • The miro-code-spec skill writes board content into a .miro/specs/ folder in your project
  • Requests carry an X-AI-Source header that tells Miro which assistant sent them (.mcp.json)
  • Miro removed its old board tools in September 2026; old guides may name tools that no longer exist

Licence and author

Licence
MIT
Author
Miro
Source code
github.com/miroapp/miro-ai

How we tested it

We installed it on an empty test computer on 15 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "gemini extensions install https://github.com/miroapp/miro-ai" (not a form the sandbox runs). Not yet used on real work.

Technical details of the test
Date
15 Oct 2026
Method
Intake sandbox run on 2026-10-15 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed miro@miro-ai with the Claude Code command line.

Checked again on 16 Oct 2026

Alternatives

  • framelink-figma-mcp: Reads Figma design files so the assistant can build pages from them, not whiteboards.
  • planning-with-files: Keeps plans as files in your project instead of on a shared board.

FAQ

Can it see all my boards? No. It sees only the boards you grant during the Miro sign-in.

Does it cost anything? The plugin is MIT licensed. The README names no paid plan. On a Miro Enterprise plan, an admin must turn on the MCP server before you can connect.

Does the code review change my pull request? Yes. After it builds the board, miro-code-review adds a block with board links to the pull request description. If it cannot edit the description, it posts a comment instead.

Can I undo a diagram? Not always. The skill file says a diagram made with the canvas tools cannot be moved or deleted through those tools. Remove it by hand in Miro.

Sources