Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.
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 |
| AI Tool | Integration |
|---|---|
| Claude Code | Plugins |
| Gemini CLI | Extensions |
| Kiro | Power |
| Agent Skills | Skills |
| Cursor, VSCode, Windsurf, etc. | MCP Config |
Select your AI tool below and follow the installation steps.
Claude Code (Recommended)
/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-aiOptional plugins:
/plugin install miro-tasks@miro-ai # Task tracking in Miro tables
/plugin install miro-solutions@miro-ai # Demo plugin generator
/plugin install miro-research@miro-ai # Research visualization
/plugin install miro-review@miro-ai # Code review workflowsRestart 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 CLI
Quick start — install the root extension for MCP access:
gemini extensions install https://github.com/miroapp/miro-aiThis installs the root gemini-extension.json, which gives Gemini access to the Miro MCP server (board reading, diagrams, tables, docs).
Full install — for commands, skills, and hooks, clone the repo and install individual extensions:
git clone https://github.com/miroapp/miro-ai.git
gemini extensions install ./miro-ai/gemini-extensions/miro
gemini extensions install ./miro-ai/gemini-extensions/miro-tasks
gemini extensions install ./miro-ai/gemini-extensions/miro-research
gemini extensions install ./miro-ai/gemini-extensions/miro-reviewRestart Gemini CLI and authenticate when prompted.
Kiro
- Open the Powers panel in Kiro
- Click Add power from GitHub
- Enter:
miroapp/miro-aiand selectpowers/code-gen
For local development, see CONTRIBUTING.md.
See Kiro Powers | Official Docs
Agent Skills (agentskills.io)
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-mcp # Install specific skillAvailable skills: miro-mcp, miro-platform, miro-code-review
Other MCP Clients (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)
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.
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!
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.
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.
| Command | What It Does |
|---|---|
/miro:browse |
Explore board contents |
/miro:diagram |
Create diagrams from text descriptions |
/miro:doc |
Create markdown documents on boards |
/miro:table |
Create tables with typed columns |
/miro:summarize |
Extract documentation from boards |
/miro-tasks:enable |
Enable automatic task tracking |
/miro-research:research |
Research topics and visualize on Miro |
| 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 |
| Plugin | Description |
|---|---|
| miro | Core MCP integration with 5 commands |
| miro-tasks | Automatic task tracking in Miro tables |
| miro-solutions | Create customer demo plugins |
| miro-research | Research and visualize findings on Miro |
| miro-review | Visual code reviews on Miro boards |
| Extension | Description |
|---|---|
| miro | Core MCP integration with commands and skills |
| miro-tasks | Task tracking commands |
| miro-research | Research visualization |
| miro-review | Code review workflows |
| Skill | Description |
|---|---|
| miro-mcp | Miro MCP tools — diagrams, documents, tables, context extraction |
| miro-platform | Miro platform overview — canvas features, content types, AI capabilities |
| miro-code-review | Code review workflows using Miro boards |
| Power | Description |
|---|---|
| code-gen | Design-to-code workflows |
- 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, 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