Summary
Connects your AI coding assistant to Miro boards through a full-featured MCP server. You get read and write access to frames, sticky notes, diagrams, tables, and documents. Ships with pre-built skills for Claude Code, Gemini CLI, Cursor, and others that handle common workflows: generating flowcharts and sequence diagrams from code, extracting design specs into your repo, syncing task tables, and running visual code reviews by posting diffs to boards. Supports OAuth so each developer authenticates individually. Especially useful if your team already sketches architecture or tracks sprints in Miro and you want your LLM to read context from those boards or push generated diagrams back without leaving your editor.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
15 tools
MIRO_CREATE_APP_CARD_ITEMTool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board (e.g., after assembling card data).6 params
Tool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board (e.g., after assembling card data).
Parameters* required
dataobjectPayload data for the app card
styleobjectStyling options for an app card item.
parentobjectParent frame reference for nesting an app card item.
board_idstringID of the board to add the app card to
geometryobjectGeometrical dimensions for an app card item.
positionobjectBoard position for an app card item.
MIRO_CREATE_BOARDTool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan".5 params
Tool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan".
Parameters* required
namestringName for the board, length between 1 and 60 characters.
policyobjectDefines permissions and sharing policies for the board.
teamIdstringUnique identifier (ID) of the team where the board will be created.
projectIdstringUnique identifier (ID) of the project (space) to which the board belongs.
descriptionstringDescription of the board, length between 0 and 300 characters.
MIRO_DELETE_APP_CARD_ITEMTool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed.2 params
Tool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed.
Parameters* required
item_idstringUnique identifier of the app card item to delete.
board_idstringUnique identifier of the board containing the app card item.
MIRO_DELETE_DOCUMENT_ITEMTool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from board 'board123'."2 params
Tool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from board 'board123'."
Parameters* required
item_idstringUnique identifier of the document item to delete.
board_idstringUnique identifier of the board containing the document item.
MIRO_DELETE_ITEMTool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs.2 params
Tool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs.
Parameters* required
item_idstringUnique identifier of the item to delete.
board_idstringUnique identifier of the board containing the item.
MIRO_GET_APP_CARD_ITEMTool to retrieve a specific app card item by its ID. Use when you need the details of an existing app card item.2 params
Tool to retrieve a specific app card item by its ID. Use when you need the details of an existing app card item.
Parameters* required
item_idstringUnique identifier of the app card item to retrieve
board_idstringUnique identifier of the board containing the app card item
MIRO_GET_BOARDTool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata.1 params
Tool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata.
Parameters* required
board_idstringUnique identifier of the board to retrieve
MIRO_GET_BOARD_ITEMSTool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting.4 params
Tool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting.
Parameters* required
typestringFilter by item type. Examples: 'shape', 'sticky_note', 'card', 'frame', 'text', 'image'
limitintegerMaximum number of items to return per page (min 1)
cursorstringCursor for paginating results; use the value from a prior response.
board_idstringUnique identifier of the board to retrieve items from
MIRO_GET_BOARD_MEMBERSTool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID.3 params
Tool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID.
Parameters* required
limitintegerNumber of results per page (max 100).
cursorstringCursor for pagination, used to retrieve subsequent pages.
board_idstringUnique identifier of the board.
MIRO_GET_BOARDSTool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords.7 params
Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords.
Parameters* required
sortstringSort order of the results.one of
default · last_created · last_opened · last_modified · alphabeticallylimitintegerNumber of boards to return per page.
ownerstringFilter boards by owner user ID.
querystringSearch query to filter boards by name.
offsetintegerOffset for pagination.
team_idstringFilter boards by team ID.
project_idstringFilter boards by project (space) ID.
MIRO_GET_CONNECTORSTool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.3 params
Tool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.
Parameters* required
limitintegerMaximum number of results to return per call (10 to 50). Defaults to 10.
cursorstringCursor for pagination to retrieve the next page of connectors.
board_idstringUnique identifier of the board to retrieve connectors from.
MIRO_GET_TAGTool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.2 params
Tool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.
Parameters* required
tag_idstringUnique identifier of the tag to retrieve.
board_idstringUnique identifier of the board where the tag resides.
MIRO_LIST_ORGANIZATIONSTool to retrieve list of organizations accessible to the user. Use when you need to view all available organizations.
Tool to retrieve list of organizations accessible to the user. Use when you need to view all available organizations.
No parameter schema in public metadata yet.
MIRO_UPDATE_APP_CARD_ITEMTool to update an app card item on a board. Use when you need to modify properties of an existing app card item. Include only fields to change.7 params
Tool to update an app card item on a board. Use when you need to modify properties of an existing app card item. Include only fields to change.
Parameters* required
dataobjectCore data for an app card item.
styleobjectStyling options for an app card item.
parentobjectParent frame reference for nesting an app card item.
item_idstringID of the app card item to update
board_idstringID of the board containing the app card item
geometryobjectGeometrical dimensions for an app card item.
positionobjectBoard position for an app card item.
MIRO_UPDATE_BOARDTool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists.6 params
Tool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists.
Parameters* required
namestringNew name for the board (1-60 characters)
policyobjectDefines permissions and sharing policies for the board
teamIdstringID of the team where the board should be placed
board_idstringUnique identifier (ID) of the board to update
projectIdstringID of the project (space) to which the board should be added
descriptionstringNew description for the board (up to 300 characters)
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.
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 |
| Codex | Local plugins |
| 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
Claude Code (Recommended)
/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, 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 CLI
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 7 bundled skills from skills/. Restart 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-browse # Install specific skill
Available skills: miro-browse, miro-code-review, miro-code-spec, miro-diagram, miro-doc, miro-table
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.
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.
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?
Skills (Claude Code)
Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.
| Skill | Triggers On |
|---|---|
miro-browse | "List the frames on …", "What's on this board …" |
miro-code-review | "Review PR 123 on …", "Visual review of this branch on …" |
miro-code-spec | "Extract specs from …", "Pull the design docs at …" |
miro-diagram | "Create a flowchart on …", "Add a sequence diagram to …" |
miro-doc | "Add a markdown doc to …", "Write a sprint plan on …" |
miro-table | "Make a task tracker table on …", "Sync these rows to …" |
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 7 bundled skills (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table) |
Gemini CLI
| Extension | Description |
|---|---|
| miro | Core MCP integration with bundled skills |
Codex
| Plugin | Description |
|---|---|
| miro | Core MCP integration with native $miro:<skill> activation and MCP access |
Agent Skills
| Skill | Description |
|---|---|
| miro-browse | List, filter, summarize items on a Miro board |
| miro-code-review | Visual code review from PRs, local changes, or branch comparisons |
| miro-code-spec | Extract Miro specs (docs, diagrams, prototypes, tables, images) to .miro/specs/ |
| miro-diagram | Create diagrams (flowchart, mindmap, UML, ER) from text or Mermaid |
| miro-doc | Create and edit markdown documents on a Miro board |
| miro-table | Create, populate, and sync structured tables on a Miro board |
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
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
