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.
Badge for your README
Markdown
[](/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
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)
- {
- "name": "miro-ai",
- "version": "1.0.0",
- "description": "Official Miro plugins for Claude Code",
- "owner": {
- "name": "Miro",
- "email": "support@miro.com"
- },
- "plugins": [
- {
- "name": "miro",
- "description": "Secure access to Miro boards. Enables AI to read board context, create diagrams, and generate code with enterprise-grade security.",
- "source": "./claude-plugins/miro",
- "category": "productivity",
- "version": "2.0.0",
- "author": {
- "name": "Miro",
- "email": "support@miro.com"
- },
- "homepage": "https://miro.com",
- "repository": "https://github.com/miroapp/miro-ai",
- "license": "MIT",
- "keywords": [
- "miro", "whiteboard", "boards", "diagrams", "flowchart", "mindmap", "uml",
- "mermaid", "plantuml", "documents", "tables", "stickies", "wireframes",
- "prototypes", "visualization", "collaboration", "design-to-code", "mcp",
- "prd", "specs", "documentation", "planning", "frames", "cards", "shapes",
- "connectors", "images", "extraction", "design", "requirements", "tasks",
- "tracking", "todos", "project-management", "kanban", "sync"
- ],
- "tags": [
- "productivity",
- "collaboration",
- "visualization",
- "design",
- "diagramming",
- "ai",
- "mcp",
- "workspace"
- ]
- }
- ]
- }
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)
- # Miro AI Developer Tools
- [](https://developers.miro.com/docs/mcp-intro)
- Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.
- 
- ---
- > [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx).
- ---
- ## What's in This Repository?
- This repo provides everything you need to connect AI tools to Miro:
- | Component | What It Does |
- |-----------|--------------|
- | **Miro MCP Server** | API that gives AI agents access to your Miro boards |
- | **Plugins & Extensions** | Pre-built integrations for popular AI tools |
- | **Documentation** | Guides for using and developing integrations |
- ### Supported AI Tools
- | AI Tool | Integration |
- |---------|-------------|
- | **Claude Code** | Plugins |
- | **Gemini CLI** | Extensions |
- | **Codex** | Local plugins |
- | **Kiro** | Power |
- | **Agent Skills** | Skills |
- | **Cursor, VSCode, Windsurf, etc.** | MCP Config |
- ---
- ## Quick Start
- ### 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>
- ```bash
- /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>
- ```bash
- 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.).
- ```bash
- 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:
- ```json
- {
- "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
- 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.
- 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.
- ---
- ## Enterprise Users
- > **Admin Approval Required**: If your organization is on a Miro Enterprise plan, your admin must enable the MCP Server before you can connect.
- >
- > See [Enterprise Guide](docs/getting-started/enterprise.md) for setup instructions.
- ---
- ## What Can You Do?
- ### Skills (Claude Code)
- Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.
- | Skill | Triggers On |
- |-------|-------------|
- | `miro-code-explain-on-board` | "Explain this codebase on …", "Visualize the architecture on …" |
- | `miro-code-review` | "Review PR 123 on …", "Visual review of this branch on …" |
- | `miro-code-spec` | "Extract specs from …", "Pull the design docs at …" |
- 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.
- ### Capabilities (All Platforms)
- | Capability | Description |
- |------------|-------------|
- | **Generate Diagrams** | Create flowcharts, sequence diagrams, ERDs from code or descriptions |
- | **Generate Code** | Convert board designs and wireframes into working code |
- | **Track Tasks** | Sync tasks between AI conversations and Miro tables |
- | **Extract Context** | Read board content to inform AI workflows |
- ---
- ## Available Plugins
- ### Claude Code
- | Plugin | Description |
- |--------|-------------|
- | [miro](docs/claude-code/miro.md) | Core MCP integration with 3 bundled skills (code-explain-on-board, code-review, code-spec) |
- ### Gemini CLI
- | Extension | Description |
- |-----------|-------------|
- | miro | Core MCP integration with bundled skills |
- ### Codex
- | Plugin | Description |
- |--------|-------------|
- | miro | Core MCP integration with native `$miro:<skill>` activation and MCP access |
- ### Agent Skills
- | Skill | Description |
- |-------|-------------|
- | miro-code-explain-on-board | Explain a codebase on a board as a minimal, notation-correct diagram set plus a companion doc |
- | miro-code-review | Visual code review from PRs, local changes, or branch comparisons |
- | miro-code-spec | Extract Miro specs (docs, diagrams, prototypes, tables, images) to `.miro/specs/` |
- ### Kiro
- | Power | Description |
- |-------|-------------|
- | [code-gen](docs/kiro/code-gen.md) | Design-to-code workflows |
- ---
- ## Security
- - **OAuth 2.1** secure authorization
- - **Enterprise compliance** standards
- - **Permission-based** access via your Miro account
- - **Rate limited** API protection
- ---
- ## Documentation
- ### Getting Started
- - [MCP Setup Guide](docs/getting-started/mcp-setup.md) — Client-specific configuration
- - [Enterprise Guide](docs/getting-started/enterprise.md) — Admin setup for enterprise
- ### Platform Guides
- - [Claude Code Plugins](docs/claude-code/overview.md)
- - [Gemini CLI Extension](docs/gemini-cli/overview.md)
- - [Cursor Plugins](docs/cursor/overview.md)
- - [Agent Skills](docs/agent-skills/overview.md)
- - [Kiro Powers](docs/kiro/overview.md)
- ### Reference
- - [MCP Tools Reference](docs/mcp/tools-reference.md)
- - [MCP Tutorials](docs/mcp/tutorials.md)
- - [Troubleshooting](docs/troubleshooting.md)
- ### Development
- - [Plugin Development Guide](docs/claude-code/plugin-development.md)
- - [Power Development Guide](docs/kiro/power-development.md)
- - [Validation](docs/validation/README.md)
- - [Contributing](CONTRIBUTING.md)
- ### External
- - [Miro Developer Docs](https://developers.miro.com/docs/mcp-intro)
- ---
- ## Supported MCP Clients
- Claude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex
- ---
- ## Feedback & Support
- - **Issues & Features**: [Open an issue](https://github.com/miroapp/miro-ai/issues)
- - **Feedback**: [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx)
- - **Community**: [Miro Developer Community](https://community.miro.com/)
- ---
- ## License
- MIT — see [LICENSE](LICENSE)
- ---
- Built with love by [Miro](https://miro.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.