Quick Start
Step 1: Choose Your AI Tool
Select your AI tool below and follow the installation steps.
Step 2: Install
/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 to avoid conflicts — the plugin already manages the MCP connection for you.
See Claude Code Plugins for full documentation.
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 | Official Docs
- Open the Powers panel in Kiro
- Click Add power from GitHub
- Enter:
miroapp/miro-ai and select powers/code-gen
For local development, see CONTRIBUTING.md.
See Kiro Powers | Official Docs
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 | agentskills.io
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 for client-specific paths.
Step 3: Authenticate
When you first use a Miro command, you'll be prompted to authenticate:
- A browser window opens with Miro OAuth
- Log in to your Miro account
- Grant access to the requested boards
- 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 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.
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 guide in Miro's Developer docs for diagnosis and cleanup steps.
Getting Started