Miro AI Developer Tools

Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.

Gemini CLI docs, diagram, table demo

Share your feedback.

What's in This Repository?

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

Supported AI Tools

AI Tool	Integration
Claude Code	Plugins
Gemini CLI	Extensions
Kiro	Power
Agent Skills	Skills
Cursor, VSCode, Windsurf, etc.	MCP Config

Quick Start

Step 1: Choose Your AI Tool

Select your AI tool below and follow the installation steps.

Step 2: Install

<details open> <summary>Claude Code (Recommended)</summary>

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

Optional 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 workflows

Restart Claude Code after installation. If you previously configured Miro MCP manually, remove the duplicate to avoid conflicts.

See Claude Code Plugins for full documentation.

</details> <details> <summary>Gemini CLI</summary>

Quick start — install the root extension for MCP access:

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

This 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-review

Restart Gemini CLI and authenticate when prompted.

See Gemini CLI Extension | Official Docs

</details> <details> <summary>Kiro</summary>

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

</details> <details> <summary>Agent Skills (agentskills.io)</summary>

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 skill

Available skills: miro-mcp, miro-platform, miro-code-review

See Agent Skills Overview | agentskills.io

</details> <details> <summary>Other MCP Clients (Cursor, VSCode, Windsurf, etc.)</summary>

Add to your MCP client configuration file:

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

See MCP Setup Guide for client-specific paths.

</details>

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.

Enterprise Users

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.

What Can You Do?

Commands (Claude Code)

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

Capabilities (All Platforms)

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

Available Plugins

Claude Code

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

Gemini CLI

Extension	Description
miro	Core MCP integration with commands and skills
miro-tasks	Task tracking commands
miro-research	Research visualization
miro-review	Code review workflows

Agent Skills

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

Kiro

Power	Description
code-gen	Design-to-code workflows

Security

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

Documentation

Getting Started

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

Platform Guides

Reference

Development

External

Miro Developer Docs

Supported MCP Clients

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

Feedback & Support

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

License

MIT — see LICENSE

Built with love by Miro

Name	code-review
Description	Knowledge and patterns for effective code review visualization

code-review

SKILL.md