Skip to content
Back to search

miro-ai

Official Miro AI developer tools and integrations. Includes MCP server configuration, Claude Code skills, and resources for building AI-powered experiences with Miro boards.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/miroapp--miro-ai/badge.svg)](/listings/miroapp--miro-ai)

HTML

<a href="/listings/miroapp--miro-ai"><img src="/api/listings/miroapp--miro-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Step 1: Choose Your AI Tool

Select your AI tool below and follow the installation steps.

Step 2: Install

<details open> <summary><strong>Claude Code</strong> (Recommended)</summary>

/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-ai

The `miro` plugin bundles all skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, format, table) and the Miro MCP server.

**Restart Claude Code** after installation. If you previously configured Miro MCP manually, [remove the duplicate](https://developers.miro.com/docs/miro-mcp-server-faq-and-troubleshooting#-duplicate-mcp-servers) to avoid conflicts — the plugin already manages the MCP connection for you.

See [Claude Code Plugins](docs/claude-code/overview.md) for full documentation.

</details>

<details> <summary><strong>Gemini CLI</strong></summary>

gemini extensions install https://github.com/miroapp/miro-ai

Gemini CLI installs the repo as an extension, registers the Miro MCP server from `gemini-extension.json`, and auto-discovers the 8 bundled skills from `skills/`. Restart Gemini CLI and authenticate when prompted.

See [Gemini CLI Extension](docs/gemini-cli/overview.md) | [Official Docs](https://geminicli.com/docs/extensions/)

</details>

<details> <summary><strong>Kiro</strong></summary>

1. Open the **Powers** panel in Kiro 2. Click **Add power from GitHub** 3. Enter: `miroapp/miro-ai` and select `powers/code-gen`

For local development, see [CONTRIBUTING.md](CONTRIBUTING.md#kiro-powers).

See [Kiro Powers](docs/kiro/overview.md) | [Official Docs](https://kiro.dev/docs/powers/installation/)

</details>

<details> <summary><strong>Agent Skills</strong> (agentskills.io)</summary>

Portable knowledge skills that work across AI coding tools (Claude Code, Cursor, VS Code + Copilot, Codex, etc.).

npx skills add miroapp/miro-ai                       # Interactive install
npx skills add miroapp/miro-ai --list                # List available skills
npx skills add miroapp/miro-ai --skill=miro-code-review   # Install specific skill

Available skills: **miro-code-explain-on-board**, **miro-code-review**, **miro-code-spec**

See [Agent Skills Overview](docs/agent-skills/overview.md) | [agentskills.io](https://agentskills.io)

</details>

<details> <summary><strong>Other MCP Clients</strong> (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)</summary>

Add to your MCP client configuration file:

{
  "mcpServers": {
    "miro": {
      "url": "https://mcp.miro.com/"
    }
  }
}

> **Note:** If a Miro plugin or extension becomes available for your client later, > switch to it and remove the manual entry to avoid duplicate servers.

See [MCP Setup Guide](docs/getting-started/mcp-setup.md) for client-specific paths.

</details>

Step 3: Authenticate

When you first use a Miro command, you'll be prompted to authenticate:

1. A browser window opens with Miro OAuth 2. Log in to your Miro account 3. Grant access to the requested boards 4. Return to your AI tool—you're connected!

Step 4: Try It

Test your setup with these example prompts:

"What's on my Miro board https://miro.com/app/board/..."
"Create a flowchart on Miro showing a user login flow"
"Summarize the architecture diagram on my Miro board"

Developer Mode

Want to modify plugins, test changes locally, or build your own? See [CONTRIBUTING.md](CONTRIBUTING.md#local-development-setup) for dev setup instructions.

Codex plugins are generated locally into `codex-plugins/*/` with the repo marketplace at `.agents/plugins/marketplace.json`. See [Codex Plugins](docs/codex/overview.md) for the generated structure and [CONTRIBUTING.md](CONTRIBUTING.md#codex-plugins) for regeneration and local testing.

Avoiding Duplicate Servers

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 43 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "miro-ai",
  3. "version": "1.0.0",
  4. "description": "Official Miro plugins for Claude Code",
  5. "owner": {
  6. "name": "Miro",
  7. "email": "support@miro.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "miro",
  12. "description": "Secure access to Miro boards. Enables AI to read board context, create diagrams, and generate code with enterprise-grade security.",
  13. "source": "./claude-plugins/miro",
  14. "category": "productivity",
  15. "version": "2.0.0",
  16. "author": {
  17. "name": "Miro",
  18. "email": "support@miro.com"
  19. },
  20. "homepage": "https://miro.com",
  21. "repository": "https://github.com/miroapp/miro-ai",
  22. "license": "MIT",
  23. "keywords": [
  24. "miro", "whiteboard", "boards", "diagrams", "flowchart", "mindmap", "uml",
  25. "mermaid", "plantuml", "documents", "tables", "stickies", "wireframes",
  26. "prototypes", "visualization", "collaboration", "design-to-code", "mcp",
  27. "prd", "specs", "documentation", "planning", "frames", "cards", "shapes",
  28. "connectors", "images", "extraction", "design", "requirements", "tasks",
  29. "tracking", "todos", "project-management", "kanban", "sync"
  30. ],
  31. "tags": [
  32. "productivity",
  33. "collaboration",
  34. "visualization",
  35. "design",
  36. "diagramming",
  37. "ai",
  38. "mcp",
  39. "workspace"
  40. ]
  41. }
  42. ]
  43. }
README.md · README · 293 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Miro AI Developer Tools
  2. [![Documentation](https://img.shields.io/badge/docs-developers.miro.com-blue)](https://developers.miro.com/docs/mcp-intro)
  3. Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.
  4. ![Gemini CLI docs, diagram, table demo](https://github.com/user-attachments/assets/54cb6aa9-9174-4d23-91a2-3cb4caa69d3d)
  5. ---
  6. > [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx).
  7. ---
  8. ## What's in This Repository?
  9. This repo provides everything you need to connect AI tools to Miro:
  10. | Component | What It Does |
  11. |-----------|--------------|
  12. | **Miro MCP Server** | API that gives AI agents access to your Miro boards |
  13. | **Plugins & Extensions** | Pre-built integrations for popular AI tools |
  14. | **Documentation** | Guides for using and developing integrations |
  15. ### Supported AI Tools
  16. | AI Tool | Integration |
  17. |---------|-------------|
  18. | **Claude Code** | Plugins |
  19. | **Gemini CLI** | Extensions |
  20. | **Codex** | Local plugins |
  21. | **Kiro** | Power |
  22. | **Agent Skills** | Skills |
  23. | **Cursor, VSCode, Windsurf, etc.** | MCP Config |
  24. ---
  25. ## Quick Start
  26. ### Step 1: Choose Your AI Tool
  27. Select your AI tool below and follow the installation steps.
  28. ### Step 2: Install
  29. <details open>
  30. <summary><strong>Claude Code</strong> (Recommended)</summary>
  31. ```bash
  32. /plugin marketplace add miroapp/miro-ai
  33. /plugin install miro@miro-ai
  34. ```
  35. The `miro` plugin bundles all skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, format, table) and the Miro MCP server.
  36. **Restart Claude Code** after installation. If you previously configured Miro MCP manually, [remove the duplicate](https://developers.miro.com/docs/miro-mcp-server-faq-and-troubleshooting#-duplicate-mcp-servers) to avoid conflicts — the plugin already manages the MCP connection for you.
  37. See [Claude Code Plugins](docs/claude-code/overview.md) for full documentation.
  38. </details>
  39. <details>
  40. <summary><strong>Gemini CLI</strong></summary>
  41. ```bash
  42. gemini extensions install https://github.com/miroapp/miro-ai
  43. ```
  44. Gemini CLI installs the repo as an extension, registers the Miro MCP server from `gemini-extension.json`, and auto-discovers the 8 bundled skills from `skills/`. Restart Gemini CLI and authenticate when prompted.
  45. See [Gemini CLI Extension](docs/gemini-cli/overview.md) | [Official Docs](https://geminicli.com/docs/extensions/)
  46. </details>
  47. <details>
  48. <summary><strong>Kiro</strong></summary>
  49. 1. Open the **Powers** panel in Kiro
  50. 2. Click **Add power from GitHub**
  51. 3. Enter: `miroapp/miro-ai` and select `powers/code-gen`
  52. For local development, see [CONTRIBUTING.md](CONTRIBUTING.md#kiro-powers).
  53. See [Kiro Powers](docs/kiro/overview.md) | [Official Docs](https://kiro.dev/docs/powers/installation/)
  54. </details>
  55. <details>
  56. <summary><strong>Agent Skills</strong> (agentskills.io)</summary>
  57. Portable knowledge skills that work across AI coding tools (Claude Code, Cursor, VS Code + Copilot, Codex, etc.).
  58. ```bash
  59. npx skills add miroapp/miro-ai # Interactive install
  60. npx skills add miroapp/miro-ai --list # List available skills
  61. npx skills add miroapp/miro-ai --skill=miro-code-review # Install specific skill
  62. ```
  63. Available skills: **miro-code-explain-on-board**, **miro-code-review**, **miro-code-spec**
  64. See [Agent Skills Overview](docs/agent-skills/overview.md) | [agentskills.io](https://agentskills.io)
  65. </details>
  66. <details>
  67. <summary><strong>Other MCP Clients</strong> (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)</summary>
  68. Add to your MCP client configuration file:
  69. ```json
  70. {
  71. "mcpServers": {
  72. "miro": {
  73. "url": "https://mcp.miro.com/"
  74. }
  75. }
  76. }
  77. ```
  78. > **Note:** If a Miro plugin or extension becomes available for your client later,
  79. > switch to it and remove the manual entry to avoid duplicate servers.
  80. See [MCP Setup Guide](docs/getting-started/mcp-setup.md) for client-specific paths.
  81. </details>
  82. ### Step 3: Authenticate
  83. When you first use a Miro command, you'll be prompted to authenticate:
  84. 1. A browser window opens with Miro OAuth
  85. 2. Log in to your Miro account
  86. 3. Grant access to the requested boards
  87. 4. Return to your AI tool—you're connected!
  88. ### Step 4: Try It
  89. Test your setup with these example prompts:
  90. ```
  91. "What's on my Miro board https://miro.com/app/board/..."
  92. ```
  93. ```
  94. "Create a flowchart on Miro showing a user login flow"
  95. ```
  96. ```
  97. "Summarize the architecture diagram on my Miro board"
  98. ```
  99. ### Developer Mode
  100. Want to modify plugins, test changes locally, or build your own? See [CONTRIBUTING.md](CONTRIBUTING.md#local-development-setup) for dev setup instructions.
  101. Codex plugins are generated locally into `codex-plugins/*/` with the repo marketplace at `.agents/plugins/marketplace.json`. See [Codex Plugins](docs/codex/overview.md) for the generated structure and [CONTRIBUTING.md](CONTRIBUTING.md#codex-plugins) for regeneration and local testing.
  102. ### Avoiding Duplicate Servers
  103. If your client has a Miro plugin or extension, use **only** that — do not also add `https://mcp.miro.com/` manually. Each installation method creates an independent MCP connection with its own OAuth session, and running more than one causes duplicate tools and auth confusion.
  104. See the [Duplicate MCP Servers](https://developers.miro.com/docs/miro-mcp-server-faq-and-troubleshooting#-duplicate-mcp-servers) guide in Miro's Developer docs for diagnosis and cleanup steps.
  105. ---
  106. ## Enterprise Users
  107. > **Admin Approval Required**: If your organization is on a Miro Enterprise plan, your admin must enable the MCP Server before you can connect.
  108. >
  109. > See [Enterprise Guide](docs/getting-started/enterprise.md) for setup instructions.
  110. ---
  111. ## What Can You Do?
  112. ### Skills (Claude Code)
  113. Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.
  114. | Skill | Triggers On |
  115. |-------|-------------|
  116. | `miro-code-explain-on-board` | "Explain this codebase on …", "Visualize the architecture on …" |
  117. | `miro-code-review` | "Review PR 123 on …", "Visual review of this branch on …" |
  118. | `miro-code-spec` | "Extract specs from …", "Pull the design docs at …" |
  119. Creating content on a board — diagrams, documents, tables, stickies, standalone formats — needs no skill. Ask for it directly; the Miro MCP server's own tools cover it and load their authoring guidance on demand.
  120. ### Capabilities (All Platforms)
  121. | Capability | Description |
  122. |------------|-------------|
  123. | **Generate Diagrams** | Create flowcharts, sequence diagrams, ERDs from code or descriptions |
  124. | **Generate Code** | Convert board designs and wireframes into working code |
  125. | **Track Tasks** | Sync tasks between AI conversations and Miro tables |
  126. | **Extract Context** | Read board content to inform AI workflows |
  127. ---
  128. ## Available Plugins
  129. ### Claude Code
  130. | Plugin | Description |
  131. |--------|-------------|
  132. | [miro](docs/claude-code/miro.md) | Core MCP integration with 3 bundled skills (code-explain-on-board, code-review, code-spec) |
  133. ### Gemini CLI
  134. | Extension | Description |
  135. |-----------|-------------|
  136. | miro | Core MCP integration with bundled skills |
  137. ### Codex
  138. | Plugin | Description |
  139. |--------|-------------|
  140. | miro | Core MCP integration with native `$miro:<skill>` activation and MCP access |
  141. ### Agent Skills
  142. | Skill | Description |
  143. |-------|-------------|
  144. | miro-code-explain-on-board | Explain a codebase on a board as a minimal, notation-correct diagram set plus a companion doc |
  145. | miro-code-review | Visual code review from PRs, local changes, or branch comparisons |
  146. | miro-code-spec | Extract Miro specs (docs, diagrams, prototypes, tables, images) to `.miro/specs/` |
  147. ### Kiro
  148. | Power | Description |
  149. |-------|-------------|
  150. | [code-gen](docs/kiro/code-gen.md) | Design-to-code workflows |
  151. ---
  152. ## Security
  153. - **OAuth 2.1** secure authorization
  154. - **Enterprise compliance** standards
  155. - **Permission-based** access via your Miro account
  156. - **Rate limited** API protection
  157. ---
  158. ## Documentation
  159. ### Getting Started
  160. - [MCP Setup Guide](docs/getting-started/mcp-setup.md) — Client-specific configuration
  161. - [Enterprise Guide](docs/getting-started/enterprise.md) — Admin setup for enterprise
  162. ### Platform Guides
  163. - [Claude Code Plugins](docs/claude-code/overview.md)
  164. - [Gemini CLI Extension](docs/gemini-cli/overview.md)
  165. - [Cursor Plugins](docs/cursor/overview.md)
  166. - [Agent Skills](docs/agent-skills/overview.md)
  167. - [Kiro Powers](docs/kiro/overview.md)
  168. ### Reference
  169. - [MCP Tools Reference](docs/mcp/tools-reference.md)
  170. - [MCP Tutorials](docs/mcp/tutorials.md)
  171. - [Troubleshooting](docs/troubleshooting.md)
  172. ### Development
  173. - [Plugin Development Guide](docs/claude-code/plugin-development.md)
  174. - [Power Development Guide](docs/kiro/power-development.md)
  175. - [Validation](docs/validation/README.md)
  176. - [Contributing](CONTRIBUTING.md)
  177. ### External
  178. - [Miro Developer Docs](https://developers.miro.com/docs/mcp-intro)
  179. ---
  180. ## Supported MCP Clients
  181. Claude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex
  182. ---
  183. ## Feedback & Support
  184. - **Issues & Features**: [Open an issue](https://github.com/miroapp/miro-ai/issues)
  185. - **Feedback**: [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx)
  186. - **Community**: [Miro Developer Community](https://community.miro.com/)
  187. ---
  188. ## License
  189. MIT — see [LICENSE](LICENSE)
  190. ---
  191. Built with love by [Miro](https://miro.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.