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.

This repo provides everything you need to connect AI tools to Miro:

Select your AI tool below and follow the installation steps.

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

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

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-browse   # Install specific skill

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

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!

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"

Want to modify plugins, test changes locally, or build your own? See CONTRIBUTING.md for dev setup instructions.

Codex plugins are generated locally into codex-plugins/*/ with the repo marketplace at .agents/plugins/marketplace.json. See Codex Plugins for the generated structure and CONTRIBUTING.md for regeneration and local testing.

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 guide in Miro's Developer docs for diagnosis and cleanup steps.

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 for setup instructions.

Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.

• OAuth 2.1 secure authorization
• Enterprise compliance standards
• Permission-based access via your Miro account
• Rate limited API protection

• MCP Setup Guide — Client-specific configuration
• Enterprise Guide — Admin setup for enterprise

• Claude Code Plugins
• Gemini CLI Extension
• Cursor Plugins
• Agent Skills
• Kiro Powers

• MCP Tools Reference
• MCP Tutorials
• Troubleshooting

• Plugin Development Guide
• Power Development Guide
• Validation
• Contributing

• Miro Developer Docs

Claude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex

• Issues & Features: Open an issue
• Feedback: Share your feedback
• Community: Miro Developer Community

MIT — see LICENSE

Built with love by Miro