Log inSubmit server
MCP Miro logo

MCP Miro

by k-jarzyna

Manage Miro boards, items, members, tags, groups, mind maps, and organization data through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Miro

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "k-jarzyna-mcp-miro": {
      "command": "npx",
      "args": [
        "-y",
        "@k-jarzyna/mcp-miro"
      ],
      "env": {
        "MIRO_ACCESS_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 97 tools correctly (4d ago).

Overview

k-jarzyna/mcp-miro MCP server connects MCP-compatible AI assistants to Miro through an API access token. It exposes tools for board management, board content, members, tags, groups, mind maps, sharing, exports, and organization or compliance data. The server runs locally through Node.js and can be launched with npx or from a built project. Reach for it when an agent needs to inspect or modify Miro workspaces rather than only discuss their contents.

Use cases

  • Create and update Miro boards from an AI assistant
  • Manage cards, sticky notes, shapes, images, and text on boards
  • Organize board content with tags and groups
  • Inspect board members and update sharing access
  • Export boards and retrieve organization or compliance records

Key features

  • Board creation, copying, updates, deletion, and sharing
  • CRUD operations for common Miro board items
  • Bulk item creation and file-based item creation
  • Tags, groups, connectors, and mind-map management
  • Board member, project member, and organization operations
  • Exports, audit logs, legal holds, cases, and classifications

Tools97

What MCP Miro lets your agent do. Expand a tool for its parameters.

Verified live~18.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 32d

What it can do

From the 97 tools this server returned when we ran it.

Can delete or modify data · 17Makes network requests · 2Read-only tools · 80
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age562 days
Maintainers1

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @k-jarzyna/mcp-miro (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars65Stargazers on the source repository.
npm downloads472Package downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed97Callable tools this server registers over MCP.

How MCP Miro works

What k-jarzyna/mcp-miro MCP server does

k-jarzyna/mcp-miro MCP server gives an MCP client access to Miro through the Miro API. Its tool surface covers both workspace administration and visual board content. An assistant can list, create, update, copy, retrieve, share, and delete boards, inspect board items, and manage board members.

The server also exposes operations for common Miro item types. These include cards, app cards, sticky notes, frames, documents, text, images, shapes, embeds, connectors, groups, tags, and mind-map nodes. Bulk creation is supported, including a file-based bulk operation. Board exports, classifications, cases, legal holds, audit logs, content logs, and organization or project membership are also represented in the available tools.

How it works

The server uses a Miro access token supplied through the MIRO_ACCESS_TOKEN environment variable. An MCP client starts the Node.js process and communicates with it using the configured command. Tool calls are translated into Miro operations, allowing the client to request reads or changes through named tools such as list-boards, create-board, get-items-on-board, or update-sticky-note-item.

The token must be created through a Miro app in the Miro Developer Portal. The documented required permissions are boards:read, boards:write, identity:read, identity:write, team:read, and team:write. Other listed permissions, including microphone, screen recording, webcam, audit-log, and session-deletion permissions, are marked optional in the project instructions.

Setup and configuration

For a quick client setup, install Node.js version 16 or newer and configure the MCP client to run npx -y @k-jarzyna/mcp-miro. Add MIRO_ACCESS_TOKEN to the process environment, then restart the client after saving its configuration. The README provides a Claude Desktop configuration using the mcpServers object and the miro server name.

For local development, install the npm dependencies, copy .env.template to .env, add the Miro token, and run npm run build. The resulting server can be started with node build/index.js. The repository instructions specifically document Claude Desktop configuration paths for macOS and Windows.

Tools and capabilities

The available tools include:

  • Board lifecycle operations, board lookup, board content retrieval, sharing, member management, and exports.
  • Creation, retrieval, modification, positioning, and deletion for many Miro item types.
  • Connector creation and maintenance, grouping and ungrouping, tagging, and bulk item creation.
  • Mind-map node operations and project membership management.
  • Organization, compliance, legal-hold, case, audit-log, classification, and content-log queries.

The exact tool names mirror the Miro operations documented by the project, using names such as create-frame, get-specific-connector, attach-tag, and get-organization-members.

Limitations and notes

k-jarzyna/mcp-miro MCP server requires a Miro account, a generated OAuth access token, and the permissions needed by the requested operations. Actions that modify boards or content require write access in the token configuration.

The project is licensed under Apache License 2.0. Client configuration details are explicitly provided for Claude Desktop; other MCP clients require their own method for launching a standard command-based server and passing the environment variable.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Miro

k-jarzyna/mcp-miro is an MCP server that connects AI assistants to Miro through an API access token. Its main tools manage boards, items, members, tags, groups, connectors, mind maps, exports, and organization data, including creating, reading, updating, and deleting supported Miro resources.

Install Node.js 16 or newer, then configure your MCP client to run `npx -y @k-jarzyna/mcp-miro`. Set `MIRO_ACCESS_TOKEN` to a Miro OAuth token and restart the client. For local development, use `npm install`, build with `npm run build`, and run `node build/index.js`.

Add a `miro` entry to Claude Desktop's `mcpServers` configuration with `command` set to `npx`, arguments `-y` and `@k-jarzyna/mcp-miro`, and `MIRO_ACCESS_TOKEN` in `env`. Save the file and restart Claude Desktop.

It requires `boards:read`, `boards:write`, `identity:read`, `identity:write`, `team:read`, and `team:write` according to the setup instructions. The README marks microphone, screen recording, webcam, audit-log, and session-deletion permissions as optional.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Miro AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/k-jarzyna-mcp-miro?style=directory)](https://allmcps.com/mcp/k-jarzyna-mcp-miro)
HTML Embed
<a href="https://allmcps.com/mcp/k-jarzyna-mcp-miro"><img src="https://allmcps.com/api/badge/k-jarzyna-mcp-miro?style=directory" alt="MCP Miro on AllMCPs" /></a>