{
"markdown": "# Miro AI Developer Tools\n\n[](https://developers.miro.com/docs/mcp-intro)\n\nConnect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation. \n\n\n\n---\n\n> [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx).\n\n---\n\n## What's in This Repository?\n\nThis repo provides everything you need to connect AI tools to Miro:\n\n| Component | What It Does |\n|-----------|--------------|\n| **Miro MCP Server** | API that gives AI agents access to your Miro boards |\n| **Plugins & Extensions** | Pre-built integrations for popular AI tools |\n| **Documentation** | Guides for using and developing integrations |\n\n### Supported AI Tools\n\n| AI Tool | Integration |\n|---------|-------------|\n| **Claude Code** | Plugins |\n| **Gemini CLI** | Extensions |\n| **Codex** | Local plugins |\n| **Kiro** | Power |\n| **Agent Skills** | Skills |\n| **Cursor, VSCode, Windsurf, etc.** | MCP Config |\n\n---\n\n## Quick Start\n\n### Step 1: Choose Your AI Tool\n\nSelect your AI tool below and follow the installation steps.\n\n### Step 2: Install\n\n\nClaude Code (Recommended)
\n\n```bash\n/plugin marketplace add miroapp/miro-ai\n/plugin install miro@miro-ai\n```\n\nThe `miro` plugin bundles all skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table) and the Miro MCP server.\n\n**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.\n\nSee [Claude Code Plugins](docs/claude-code/overview.md) for full documentation.\n\n \n\n\nGemini CLI
\n\n```bash\ngemini extensions install https://github.com/miroapp/miro-ai\n```\n\nGemini CLI installs the repo as an extension, registers the Miro MCP server from `gemini-extension.json`, and auto-discovers the 7 bundled skills from `skills/`. Restart Gemini CLI and authenticate when prompted.\n\nSee [Gemini CLI Extension](docs/gemini-cli/overview.md) | [Official Docs](https://geminicli.com/docs/extensions/)\n\n \n\n\nKiro
\n\n1. Open the **Powers** panel in Kiro\n2. Click **Add power from GitHub**\n3. Enter: `miroapp/miro-ai` and select `powers/code-gen`\n\nFor local development, see [CONTRIBUTING.md](CONTRIBUTING.md#kiro-powers).\n\nSee [Kiro Powers](docs/kiro/overview.md) | [Official Docs](https://kiro.dev/docs/powers/installation/)\n\n \n\n\nAgent Skills (agentskills.io)
\n\nPortable knowledge skills that work across AI coding tools (Claude Code, Cursor, VS Code + Copilot, Codex, etc.).\n\n```bash\nnpx skills add miroapp/miro-ai # Interactive install\nnpx skills add miroapp/miro-ai --list # List available skills\nnpx skills add miroapp/miro-ai --skill=miro-browse # Install specific skill\n```\n\nAvailable skills: **miro-browse**, **miro-code-review**, **miro-code-spec**, **miro-diagram**, **miro-doc**, **miro-table**\n\nSee [Agent Skills Overview](docs/agent-skills/overview.md) | [agentskills.io](https://agentskills.io)\n\n \n\n\nOther MCP Clients (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)
\n\nAdd to your MCP client configuration file:\n\n```json\n{\n \"mcpServers\": {\n \"miro\": {\n \"url\": \"https://mcp.miro.com/\"\n }\n }\n}\n```\n\n> **Note:** If a Miro plugin or extension becomes available for your client later,\n> switch to it and remove the manual entry to avoid duplicate servers.\n\nSee [MCP Setup Guide](docs/getting-started/mcp-setup.md) for client-specific paths.\n\n \n\n### Step 3: Authenticate\n\nWhen you first use a Miro command, you'll be prompted to authenticate:\n\n1. A browser window opens with Miro OAuth\n2. Log in to your Miro account\n3. Grant access to the requested boards\n4. Return to your AI tool—you're connected!\n\n### Step 4: Try It\n\nTest your setup with these example prompts:\n\n```\n\"What's on my Miro board https://miro.com/app/board/...\"\n```\n\n```\n\"Create a flowchart on Miro showing a user login flow\"\n```\n\n```\n\"Summarize the architecture diagram on my Miro board\"\n```\n\n### Developer Mode\n\nWant to modify plugins, test changes locally, or build your own? See [CONTRIBUTING.md](CONTRIBUTING.md#local-development-setup) for dev setup instructions.\n\nCodex 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.\n\n### Avoiding Duplicate Servers\n\nIf 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.\n\nSee 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.\n\n---\n\n## Enterprise Users\n\n> **Admin Approval Required**: If your organization is on a Miro Enterprise plan, your admin must enable the MCP Server before you can connect.\n>\n> See [Enterprise Guide](docs/getting-started/enterprise.md) for setup instructions.\n\n---\n\n## What Can You Do?\n\n### Skills (Claude Code)\n\nSkills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.\n\n| Skill | Triggers On |\n|-------|-------------|\n| `miro-browse` | \"List the frames on …\", \"What's on this board …\" |\n| `miro-code-review` | \"Review PR 123 on …\", \"Visual review of this branch on …\" |\n| `miro-code-spec` | \"Extract specs from …\", \"Pull the design docs at …\" |\n| `miro-diagram` | \"Create a flowchart on …\", \"Add a sequence diagram to …\" |\n| `miro-doc` | \"Add a markdown doc to …\", \"Write a sprint plan on …\" |\n| `miro-table` | \"Make a task tracker table on …\", \"Sync these rows to …\" |\n\n### Capabilities (All Platforms)\n\n| Capability | Description |\n|------------|-------------|\n| **Generate Diagrams** | Create flowcharts, sequence diagrams, ERDs from code or descriptions |\n| **Generate Code** | Convert board designs and wireframes into working code |\n| **Track Tasks** | Sync tasks between AI conversations and Miro tables |\n| **Extract Context** | Read board content to inform AI workflows |\n\n---\n\n## Available Plugins\n\n### Claude Code\n\n| Plugin | Description |\n|--------|-------------|\n| [miro](docs/claude-code/miro.md) | Core MCP integration with 7 bundled skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table) |\n\n### Gemini CLI\n\n| Extension | Description |\n|-----------|-------------|\n| miro | Core MCP integration with bundled skills |\n\n### Codex\n\n| Plugin | Description |\n|--------|-------------|\n| miro | Core MCP integration with native `$miro:` activation and MCP access |\n\n### Agent Skills\n\n| Skill | Description |\n|-------|-------------|\n| miro-browse | List, filter, summarize items on a Miro board |\n| miro-code-review | Visual code review from PRs, local changes, or branch comparisons |\n| miro-code-spec | Extract Miro specs (docs, diagrams, prototypes, tables, images) to `.miro/specs/` |\n| miro-diagram | Create diagrams (flowchart, mindmap, UML, ER) from text or Mermaid |\n| miro-doc | Create and edit markdown documents on a Miro board |\n| miro-table | Create, populate, and sync structured tables on a Miro board |\n\n### Kiro\n\n| Power | Description |\n|-------|-------------|\n| [code-gen](docs/kiro/code-gen.md) | Design-to-code workflows |\n\n---\n\n## Security\n\n- **OAuth 2.1** secure authorization\n- **Enterprise compliance** standards\n- **Permission-based** access via your Miro account\n- **Rate limited** API protection\n\n---\n\n## Documentation\n\n### Getting Started\n- [MCP Setup Guide](docs/getting-started/mcp-setup.md) — Client-specific configuration\n- [Enterprise Guide](docs/getting-started/enterprise.md) — Admin setup for enterprise\n\n### Platform Guides\n- [Claude Code Plugins](docs/claude-code/overview.md)\n- [Gemini CLI Extension](docs/gemini-cli/overview.md)\n- [Cursor Plugins](docs/cursor/overview.md)\n- [Agent Skills](docs/agent-skills/overview.md)\n- [Kiro Powers](docs/kiro/overview.md)\n\n### Reference\n- [MCP Tools Reference](docs/mcp/tools-reference.md)\n- [MCP Tutorials](docs/mcp/tutorials.md)\n- [Troubleshooting](docs/troubleshooting.md)\n\n### Development\n- [Plugin Development Guide](docs/claude-code/plugin-development.md)\n- [Power Development Guide](docs/kiro/power-development.md)\n- [Validation](docs/validation/README.md)\n- [Contributing](CONTRIBUTING.md)\n\n### External\n- [Miro Developer Docs](https://developers.miro.com/docs/mcp-intro)\n\n---\n\n## Supported MCP Clients\n\nClaude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex\n\n---\n\n## Feedback & Support\n\n- **Issues & Features**: [Open an issue](https://github.com/miroapp/miro-ai/issues)\n- **Feedback**: [Share your feedback](https://q2oeb0jrhgi.typeform.com/to/YATmJPVx)\n- **Community**: [Miro Developer Community](https://community.miro.com/)\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\nBuilt with love by [Miro](https://miro.com)\n",
"bytes": 9694,
"sha": "bee1f3ef97514109d6009f72c2464e7aba423a5412ed1b681e73e516bb8b1934",
"repo_slug": "miroapp/miro-ai",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_miroapp_miro_ai_miro_dc39040f/readme"
}