The io.github.miroapp/mcp-server is an official Model Context Protocol (MCP) server that connects AI coding assistants to Miro boards. It supports context to code, and enables creating diagrams, docs, and data tables through natural conversation.
🛠️ Key Features
Context to code from Miro board content
Create diagrams, documentation, and data tables
Work through natural conversation with AI coding assistants
🚀 Use Cases
Generate code based on designs created in Miro
Produce diagrams and documentation from board context
Extract or generate data tables from board content
⚡ Developer Benefits
Integrates Miro board workflows into AI coding assistant interactions
Enables conversion of design context into code and structured outputs
Connect AI coding assistants to your Miro boards. Create diagrams, extract context, generate code from designs, and track tasks—all through natural conversation.
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.
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.
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:
code
"What's on my Miro board https://miro.com/app/board/..."
code
"Create a flowchart on Miro showing a user login flow"
code
"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.
Skills auto-activate when you describe what you want naturally. No slash commands required — just include a Miro board URL.
Skill
Triggers On
miro-code-explain-on-board
"Explain this codebase on …", "Visualize the architecture on …"
miro-code-review
"Review PR 123 on …", "Visual review of this branch on …"
miro-code-spec
"Extract specs from …", "Pull the design docs at …"
Creating content on a board — diagrams, documents, tables, stickies, standalone formats — needs no skill. Ask for it directly; the Miro MCP server's own tools cover it and load their authoring guidance on demand.
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
