Miro

io.github.miroappPublished by GitHub account miroappv1.0.2Updated Nov 2, 2026

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Official Miro MCP server that lets an AI assistant read Miro boards, create diagrams, docs and tables, and turn designs into code.

What you can do
  • Read and extract context from Miro boards to inform AI workflows
  • Create diagrams such as flowcharts, sequence diagrams and ERDs from code or descriptions
  • Create documents, tables, stickies and standalone formats on a board
  • Convert board designs and wireframes into working code
  • Sync tasks between AI conversations and Miro tables
  • Bundle optional skills for code explanation, visual code review and spec extraction
When to use it
Useful when you work in Miro and want an AI coding assistant to read existing boards, draw architecture or flow diagrams, keep tasks in Miro tables, or turn wireframes into code. It fits teams already using Miro alongside Claude Code, Cursor, VS Code, Gemini CLI or similar clients.
Requirements
A remote MCP endpoint at mcp.miro.com added to the client configuration; no local package needed. A Miro account with OAuth 2.1 sign-in and browser access to grant board permissions. On Miro Enterprise plans an admin must enable the MCP server first.
Before you install
OAuth grants the assistant access to the boards you approve, and it can create and change board content, so review permissions and edits. Do not add both a Miro plugin and the manual endpoint, since each creates a separate OAuth session and duplicate tools. Enterprise access depends on admin approval.

Installation

In SourceWeft

  1. Open Miro in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.miroapp%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

Miro AI Developer Tools

[Documentation]

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:

ComponentWhat It Does
Miro MCP ServerAPI that gives AI agents access to your Miro boards
Plugins & ExtensionsPre-built integrations for popular AI tools
DocumentationGuides for using and developing integrations

Supported AI Tools

AI ToolIntegration
Claude CodePlugins
Gemini CLIExtensions
CodexLocal plugins
KiroPower
Agent SkillsSkills
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)
bash
/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 CLI
bash
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

Kiro
  1. Open the Powers panel in Kiro
  2. Click Add power from GitHub
  3. Enter: miroapp/miro-ai and select powers/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.).

bash
npx skills add miroapp/miro-ai                       # Interactive installnpx skills add miroapp/miro-ai --list                # List available skillsnpx 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

Other MCP Clients (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit, etc.)

Add to your MCP client configuration file:

json
{  "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:

  1. A browser window opens with Miro OAuth
  2. Log in to your Miro account
  3. Grant access to the requested boards
  4. 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.

SkillTriggers 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)

CapabilityDescription
Generate DiagramsCreate flowcharts, sequence diagrams, ERDs from code or descriptions
Generate CodeConvert board designs and wireframes into working code
Track TasksSync tasks between AI conversations and Miro tables
Extract ContextRead board content to inform AI workflows

Available Plugins

Claude Code

PluginDescription
miroCore MCP integration with 3 bundled skills (code-explain-on-board, code-review, code-spec)

Gemini CLI

ExtensionDescription
miroCore MCP integration with bundled skills

Codex

PluginDescription
miroCore MCP integration with native $miro:<skill> activation and MCP access

Agent Skills

SkillDescription
miro-code-explain-on-boardExplain a codebase on a board as a minimal, notation-correct diagram set plus a companion doc
miro-code-reviewVisual code review from PRs, local changes, or branch comparisons
miro-code-specExtract Miro specs (docs, diagrams, prototypes, tables, images) to .miro/specs/

Kiro

PowerDescription
code-genDesign-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

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

License

MIT — see LICENSE

Built with love by Miro

Source: README.md at commit b6408e1

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts