[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@miroapp/miro-ai' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","miroapp","moduleId","miro-ai","@miroapp/miro-ai","displayName","Miro","tagline","Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.","iconKey","https://avatars.githubusercontent.com/u/48276018?v=4","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.miro.com/\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363504000,"updatedAt",1781499744000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.miroapp%2Fmcp-server","sourceVerified",true,"importedAt","upstreamStars",120,"upstreamUpdatedAt",1780465200000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/miroapp/miro-ai","githubRepoFullName","miroapp/miro-ai","releaseId","ext-miroapp-miro-ai","version","1.0.2","descriptionMarkdown","# Miro AI Developer Tools\n\n[![Documentation](https://img.shields.io/badge/docs-developers.miro.com-blue)](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![Gemini CLI docs, diagram, table demo](https://github.com/user-attachments/assets/54cb6aa9-9174-4d23-91a2-3cb4caa69d3d)\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

Claude 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, 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](https://github.com/miroapp/miro-ai/blob/main/docs/claude-code/overview.md) for full documentation.\n\n

\n\n

Gemini 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 6 bundled skills from `skills/`. Restart Gemini CLI and authenticate when prompted.\n\nSee [Gemini CLI Extension](https://github.com/miroapp/miro-ai/blob/main/docs/gemini-cli/overview.md) | [Official Docs](https://geminicli.com/docs/extensions/)\n\n

\n\n

Kiro

\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](https://github.com/miroapp/miro-ai/blob/main/CONTRIBUTING.md#kiro-powers).\n\nSee [Kiro Powers](https://github.com/miroapp/miro-ai/blob/main/docs/kiro/overview.md) | [Official Docs](https://kiro.dev/docs/powers/installation/)\n\n

\n\n

Agent 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](https://github.com/miroapp/miro-ai/blob/main/docs/agent-skills/overview.md) | [agentskills.io](https://agentskills.io)\n\n

\n\n

Other 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](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/docs/codex/overview.md) for the generated structure and [CONTRIBUTING.md](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/docs/claude-code/miro.md) | Core MCP integration with 6 bundled skills (browse, code-review, code-spec, 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](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/docs/getting-started/mcp-setup.md) — Client-specific configuration\n- [Enterprise Guide](https://github.com/miroapp/miro-ai/blob/main/docs/getting-started/enterprise.md) — Admin setup for enterprise\n\n### Platform Guides\n- [Claude Code Plugins](https://github.com/miroapp/miro-ai/blob/main/docs/claude-code/overview.md)\n- [Gemini CLI Extension](https://github.com/miroapp/miro-ai/blob/main/docs/gemini-cli/overview.md)\n- [Cursor Plugins](https://github.com/miroapp/miro-ai/blob/main/docs/cursor/overview.md)\n- [Agent Skills](https://github.com/miroapp/miro-ai/blob/main/docs/agent-skills/overview.md)\n- [Kiro Powers](https://github.com/miroapp/miro-ai/blob/main/docs/kiro/overview.md)\n\n### Reference\n- [MCP Tools Reference](https://github.com/miroapp/miro-ai/blob/main/docs/mcp/tools-reference.md)\n- [MCP Tutorials](https://github.com/miroapp/miro-ai/blob/main/docs/mcp/tutorials.md)\n- [Troubleshooting](https://github.com/miroapp/miro-ai/blob/main/docs/troubleshooting.md)\n\n### Development\n- [Plugin Development Guide](https://github.com/miroapp/miro-ai/blob/main/docs/claude-code/plugin-development.md)\n- [Power Development Guide](https://github.com/miroapp/miro-ai/blob/main/docs/kiro/power-development.md)\n- [Validation](https://github.com/miroapp/miro-ai/blob/main/docs/validation/README.md)\n- [Contributing](https://github.com/miroapp/miro-ai/blob/main/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](https://github.com/miroapp/miro-ai/blob/main/LICENSE)\n\n---\n\nBuilt with love by [Miro](https://miro.com)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.miroapp/mcp-server","homepage","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]