Skip to main content
Glama

Miro MCP Server

Run your Miro workshops, retros, and planning sessions from the command line. Read boards, create stickies, organize frames, and generate diagrams through Claude, Cursor, or any MCP client.

Community project — Not officially affiliated with Miro. See official options below.

110 tools | Single binary | All platforms | All major AI tools

CI lint CodeScene Average Code Health License: MIT Go Reference codecov MCP context


Documentation

Document

Description

QUICKSTART.md

Get running in 2 minutes

SETUP.md

Full setup for all AI tools

CONFIG.md

Configuration reference

PERFORMANCE.md

Optimization guide

CHANGELOG.md

Version history

ERRORS.md

Error handling & troubleshooting


Related MCP server: Miro MCP

Quick Start

1. Install

Homebrew (macOS/Linux):

brew tap olgasafonova/tap && brew install miro-mcp-server

One-liner (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/olgasafonova/miro-mcp-server/main/install.sh | sh

Docker:

docker pull ghcr.io/olgasafonova/miro-mcp-server:latest

Manual download: See SETUP.md for all platforms

2. Get a Miro Token

  1. Go to miro.com/app/settings/user-profile/apps

  2. Create an app with boards:read and boards:write permissions

  3. Install to your team and copy the token

3. Configure Your AI Tool

Claude Code:

claude mcp add miro -e MIRO_ACCESS_TOKEN=your-token -- miro-mcp-server

Claude Desktop / Cursor / VS Code: See SETUP.md

Cursor Marketplace:

/add-plugin miro

Not working? Tell us what made it hard — even one sentence helps.


What You Can Do

Category

Examples

Boards

Create, copy, delete, update, share, list members

Items

Sticky notes, shapes, text, cards, app cards, images, documents, frames, docs

Diagrams

Generate flowcharts and sequence diagrams from Mermaid; list and inspect native diagram items

Docs

Create and manage Markdown documents on boards

Upload

Upload and replace local image and document files on boards

Tables

Discover and inspect tables on boards

Mindmaps

Create mindmap nodes with parent-child relationships

Code Widgets

Syntax-highlighted code snippets on boards (v2-experimental)

Bulk Ops

Create multiple items at once, sticky grids

Tags

Create, attach, update, and organize with tags

Groups

Group, list, and manage item groups

Connectors

Connect items with styled arrows

Export

Board thumbnails, PDF/SVG export (Enterprise)

Voice Examples

  • "Add a yellow sticky saying 'Review PRs'"

  • "Create a flowchart: Start → Decision → End"

  • "What boards do I have?"

  • "Share the Design board with jane@example.com"

  • "Create a mindmap with 'Project Ideas' as root"


Companion Skill: miro-workflow

Validated by SkillCheck Pro

For Claude clients that support skills (Claude Code, Claude Desktop), this repo includes a miro-workflow skill that describes how to assemble a few common board layouts from the atomic create-item tools.

Five layouts are covered:

Workflow

Trigger phrase examples

Sprint Board

"set up a sprint board for sprint 42"

Retrospective

"create a retro board for our team"

Brainstorm

"brainstorm board for [topic]"

Story Map

"map the user journey for [product]"

Kanban

"kanban for our backlog"

Each one specifies frame sizes, gap math, sticky placement, color conventions (the Miro API takes hex for frame fills and named values for stickies; two different vocabularies), and the tool-call order to follow. For single-tool calls ("add one sticky") or read-only inspection, the atomic tools are usually enough on their own.

The skill is new and likely needs adjustment as more layouts get exercised against real boards. Files live under skills/miro-workflow/. Claude Code auto-discovers skills from ~/Projects/claude-code-config/skills/; for other hosts, follow your client's skill installation docs.

The badge above is awarded by SkillCheck Pro; this skill currently scores 92/100 with zero Critical issues and zero Warnings. Skills in this repo earn the badge at ≥90/100 with zero Critical and zero Warnings; below that bar, the badge is dropped until the skill passes again.


Companion CLI: miro-cli

For shell-first usage, this server has a sibling: miro-cli. Same author, same Miro API coverage, different runtime. One verb per endpoint, JSON in and out, plus a local SQLite mirror for offline search. Reach for it when you're scripting Miro in CI, bulk-migrating stickies between boards, or querying boards offline without burning API quota.

The MCP server and the CLI overlap deliberately. Use the MCP server when an agent runtime is in the loop (Claude Code, Claude Desktop, Cursor). Use the CLI when bash, Makefiles, or CI are. Use both if you want.

Install:

brew install olgasafonova/tap/miro-cli
# or
go install github.com/olgasafonova/miro-cli/cmd/miro-cli@latest

Companion MCP Apps server: miro-mcp-apps

If you want Miro data to render as interactive UI in the chat (cards, tables, color clusters, SVG graphs) instead of streamed JSON, there's a TypeScript sibling: miro-mcp-apps. Eleven tools built on the MCP Apps extension (SEP-1865), reusing the same MIRO_ACCESS_TOKEN. The two servers run side-by-side: this one for the 110-tool CRUD surface, that one for visual at-a-glance views.

You want…

Use

Programmatic control: create/update/move/connect items, generate diagrams

miro-mcp-server (this repo)

Visual board summaries, sticky color clusters, connector graphs rendered inline

miro-mcp-apps

Same in bash, CI, or a Makefile

miro-cli

The MCP Apps pattern is TypeScript-only today (Go SDK has no ext-apps helpers), which is why this companion lives in a separate repo instead of bolting onto the Go server.


Token Efficiency

The full tool surface (110 tools) costs roughly 20.8K tokens of preload; the essentials profile trims that to ~2.8K. For sessions where that footprint matters, set MIRO_TOOLS_PROFILE=essentials in your client config; the server then registers a curated 14-tool subset (boards, list/find/search, sticky/text/frame/connector creation, list/get/update/delete items) plus one discovery meta-tool. Agents reach the rest via miro_tool_search on demand.

Profile

Tools

Preload tokens (est.)

full (default)

110

~20,795

essentials

15

~2,848

Savings: ~17,760 tokens (86.2% reduction) when you opt into essentials. Description tokens are exact (JSON-marshaled); schema cost is estimated at 200 bytes per tool. Reproduce locally with go run ./cmd/token-count/.

miro_tool_search(query?, category?, limit?) is registered in both profiles. It searches tool names, titles, descriptions, and categories with weighted keyword scoring (name 3×, title 2×, category 2.5×, description 1×), returns up to 50 matches, and never recommends itself. Use it when you don't know which tool to reach for, or to scope to a category before browsing. Empty query plus a category returns the category's tools alphabetically.

See CONFIG.md for the full env-var reference.


All 110 Tools

Tool

Description

miro_list_boards

List accessible boards with owner, team, and timestamps

miro_find_board

Find board by name, with the same metadata as the listing

miro_get_board

Get board details

miro_get_board_summary

Get board stats and item counts

miro_get_board_content

Get all board content for AI analysis

miro_create_board

Create a new board

miro_copy_board

Copy an existing board

miro_update_board

Update board name/description

miro_delete_board

Delete a board

Tool

Description

miro_list_board_members

List users with access

miro_get_board_member

Get member details

miro_share_board

Share board via email (requires MIRO_SHARE_ALLOWED_DOMAINS; fail-closed by default)

miro_update_board_member

Update member role (Destructive: prompts before role escalation)

miro_remove_board_member

Remove member from board

Sharing and role-change tools are guarded for prompt-injection safety. See SECURITY.md and CONFIG.md.

Tool

Description

miro_create_sticky

Create a sticky note

miro_create_sticky_grid

Create stickies in a grid layout

miro_create_shape

Create a shape (rectangle, circle, etc.)

miro_create_flowchart_shape

Create flowchart shape (experimental API)

miro_create_text

Create text element

miro_create_frame

Create a frame container

miro_create_card

Create a card with due date

miro_create_app_card

Create app card with custom fields

miro_create_image

Add image from URL

miro_upload_image

Upload local image file

miro_upload_document

Upload local document file (PDF, DOCX, etc.)

miro_create_doc

Create Markdown document

miro_create_document

Add document from URL

miro_create_embed

Embed YouTube, Figma, etc.

miro_create_connector

Connect two items with arrow

miro_create_group

Group items together

miro_create_mindmap_node

Create mindmap node

miro_bulk_create

Create multiple items at once

Tool

Description

miro_get_frame

Get frame details

miro_update_frame

Update frame title/color/size

miro_delete_frame

Delete a frame

miro_get_frame_items

List items inside a frame

Tool

Description

miro_get_mindmap_node

Get node details

miro_list_mindmap_nodes

List all mindmap nodes

miro_delete_mindmap_node

Delete a mindmap node

Tool

Description

miro_create_code_widget

Add a syntax-highlighted code snippet

miro_get_code_widget

Get full source and settings

miro_list_code_widgets

List widgets with code previews

miro_update_code_widget

Change code, language, title, or size

miro_move_code_widget

Move to a new position

miro_delete_code_widget

Delete a code widget

Tool

Description

miro_create_comment

Open a comment thread, optionally attached to an item

miro_list_comments

List threads with messages and resolved state

miro_get_comment

Get one thread with its full message history

miro_reply_comment

Append a reply to a thread

miro_resolve_comment

Resolve a thread, or reopen with resolved=false

Tool

Description

miro_read_board_svg

Render board items as an SVG document (computed locally); frame_id scopes the render to one frame

miro_create_from_svg

Create items from SVG: shapes, text, stickies and frames (data-type hints), triangles, images, connectors (line with data-start/data-end)

miro_update_from_svg

Apply an SVG diff keyed on data-miro-id: update in place, delete (data-deleted), create additively; read output is re-submittable

Tool

Description

miro_list_items

List items on a board

miro_list_all_items

Get ALL items with auto-pagination

miro_get_item

Get item details

miro_get_image

Get image details and Miro-hosted URL

miro_get_document

Get document details and Miro-hosted URL

miro_get_app_card

Get app card details

miro_get_doc

Get Markdown document content

miro_search_board

Search items by content

miro_who_am_i

Introspect the access token: user, team, organization, application, scopes

Tool

Description

miro_update_item

Update item content/position/color

miro_update_sticky

Update sticky note (shape, color)

miro_update_shape

Update shape (fill, text color, type)

miro_update_text

Update text element

miro_update_card

Update card fields

miro_update_image

Update image properties

miro_update_image_from_file

Replace image file on existing item

miro_update_document

Update document properties

miro_update_document_from_file

Replace document file on existing item

miro_update_embed

Update embed properties

miro_update_group

Update group properties

miro_update_app_card

Update app card fields

miro_bulk_update

Update multiple items at once

miro_delete_item

Delete an item

miro_delete_app_card

Delete an app card

miro_update_doc

Update document content (full or find-and-replace)

miro_delete_doc

Delete a Markdown document

miro_bulk_delete

Delete multiple items at once

Tool

Description

miro_create_tag

Create a tag

miro_list_tags

List all tags on board

miro_get_tag

Get tag details by ID

miro_attach_tag

Attach tag to item

miro_detach_tag

Remove tag from item

miro_get_item_tags

Get tags on an item

miro_get_items_by_tag

Get all items with a specific tag

miro_update_tag

Update tag name/color

miro_delete_tag

Delete a tag

Tool

Description

miro_list_connectors

List all connectors

miro_get_connector

Get connector details

miro_update_connector

Update connector style/caption

miro_delete_connector

Delete a connector

Tool

Description

miro_list_groups

List all groups on board

miro_get_group

Get group details

miro_get_group_items

List items in a group

miro_delete_group

Delete or ungroup a group

Tool

Description

miro_get_board_picture

Get board thumbnail

miro_create_export_job

Export to PDF/SVG (Enterprise)

miro_get_export_job_status

Check export progress

miro_get_export_job_results

Get download links

Tool

Description

miro_list_tables

List tables (data_table_format) on a board

miro_get_table

Get table metadata by ID

Tool

Description

miro_tool_search

Find the right tool by keyword or category; registered in both profiles and the only gateway to the full surface in essentials mode

Tool

Description

miro_generate_diagram

Create diagram from Mermaid syntax

miro_list_diagrams

List native diagram items on a board

miro_get_diagram

Get native diagram metadata by ID

miro_get_audit_log

Query THIS SERVER's local execution log

miro_get_org_audit_logs

Query MIRO's org-wide audit log (Enterprise; auditlogs:read)

miro_get_desire_paths

Query agent normalization patterns (what agents sent vs. what got auto-corrected)


Diagram Generation

Create flowcharts and sequence diagrams from Mermaid syntax:

Flowchart:

flowchart TB
    A[Start] --> B{Decision}
    B -->|Yes| C[Success]
    B -->|No| D[Retry]
    D --> B

Sequence Diagram:

sequenceDiagram
    Alice->>Bob: Hello Bob!
    Bob-->>Alice: Hi Alice!

Supported: flowchart/graph, sequenceDiagram, directions (TB/LR/BT/RL), shapes ([] rectangle, {} diamond, (()) circle), labeled edges.


Why This Server?

Feature

This Server

TypeScript alternatives

Runtime

Single binary

Requires Node.js

Size

~14MB

100MB+ with node_modules

Startup

~50ms

500ms-2s

Memory

~10MB idle

~50MB idle

Diagram generation

Built-in Mermaid parser

AI-based

Rate limiting

Automatic with backoff

Manual

Caching

2-minute TTL

None

Circuit breaker

Yes

No


Official vs Community

Miro opened a beta of their official MCP server in December 2025, with around 10 tools, and has grown it substantially since. Comparison refreshed 07-11-2026 by enumerating the 42 tools the hosted server actually registers at mcp.miro.com, rather than counting the documented set — the docs lag the deployment in both directions, and the surface moves fast enough that a count is perishable: 65 on 13-08-2026, 63 on 18-08, 61 on 09-09, 45 on 18-09, 42 on 07-11.

Between 18-09 and 07-11-2026 the official server dropped two whole families and added five tools. Gone: all three prototype tools (prototype_create, prototype_read, prototype_get_upload_url), four of the five table tools (table_create, table_list_rows, table_sync_rows, table_update_view; only table_get_latest_update_history remains) and preview_resource_poll. New: content_search searches boards, spaces and video call recordings, including the text inside boards; create_boardcast records a narrated, replayable walkthrough of a board with generated voice; get_brand_context returns the organization's brand theme and guidelines; user_search_organization_users resolves people by name before sharing; and canvas_get_html_upload_url uploads HTML widgets of up to 1 MB out of band. Every official tool currently also asks the calling agent to report is_repository, whether it is running inside a source-control repository.

The September drop is a consolidation rather than attrition. Every one of the sixteen removed tools is a content read or write path superseded by the canvas_* family — board_list_items, board_show, context_explore, context_get, all three diagram_*, all three doc_*, all four layout_* — and the server's own connection instructions now lead with Canvas Composer SVG as "Miro's unified interaction/representation protocol for the canvas". The 09-09 pass saw it coming: layout_* were still registered but already self-describing as deprecated in favour of canvas. Earlier churn: board_trash and space_delete, present on 17-08-2026, were gone the next day, leaving the surface with no hard-destructive verbs; all five code_widget_* tools present on 18-08 were gone by 09-09, while canvas_search, canvas_load_format_skill and content_item_list_roles arrived. Recent additions come from their changelogs on new MCP tools and code widget endpoints.

Feature

This Server

Official Miro MCP

Tools

110 (or 15 in essentials profile)

42

Transport

stdio + HTTP

HTTPS only (hosted at mcp.miro.com)

Self-hosting

Yes

No

Offline mode

Yes

No

Auth

Token + OAuth2

OAuth 2.1, dynamic client registration (Enterprise orgs need admin enablement)

Board list metadata

id, owner, team, created/modified timestamps

name and URL

Diagram generation

Mermaid, parsed locally; native diagram items readable via miro_list_diagrams/miro_get_diagram

None since 18-09-2026 (diagram_create_mermaid, diagram_update_mermaid and diagram_get_mermaid_instructions removed; diagrams now go through the canvas SVG tools)

AI context

No

None since 18-09-2026 (context_explore and context_get removed)

Layout DSL

Composed from bulk create + the miro-workflow skill

None since 18-09-2026 — all four layout_* tools removed, having self-described as deprecated in favour of the canvas tools on 09-09

Canvas as SVG

Read + create + update (data-miro-id diff; local geometry transform; spatial approximation). Reads scope to a single frame via frame_id, and read output is directly re-submittable to the update tool

Yes (read, create, update from SVG). Reads scope to a rectangle or a widget_ids list and refuse areas above 500 widgets; canvas_search (pattern and regex over the SVG) narrows the scope first. Read output is re-escaped, so it cannot be fed back to the update tool verbatim. HTML widgets up to 1 MB via canvas_get_html_upload_url

Spaces & sections

No

Yes (10 tools) — workspace-level grouping of boards, not board content

Comments

Yes (create, list, get, reply, resolve; v2-experimental)

Yes (create, list, reply, resolve)

Prototypes

No

None since 07-11-2026 (prototype_create, prototype_read and prototype_get_upload_url removed)

Code widgets

6 tools incl. position move (v2-experimental)

None since 09-09-2026 (5 tools on 18-08-2026)

Docs & Tables

Doc formats + table read

Table row-update history only (table_get_latest_update_history); table create, list-rows, sync and view tools removed by 07-11-2026, all three doc_* tools on 18-09-2026

Images

Create, upload, update from file

Create, upload URL, get data/URL

Bulk operations

Yes

No (table_sync_rows, its only bulk path, removed by 07-11-2026)

Search

Within a board (miro_search_board) and board names (miro_find_board)

Across boards, spaces and video call recordings, including text inside boards (content_search), plus canvas_search within a board

Narrated walkthroughs

No

Yes (create_boardcast: talktrack-style recording with generated voice)

Brand context

No

Yes (get_brand_context: organization theme, typography and guidelines)

Mindmaps

Yes

No

Tags & Groups

Yes

No

Connectors CRUD

Yes

No

Item-level CRUD

Yes (sticky, shape, text, card, image, document, embed, frame)

Canvas SVG, not per-item verbs

Board sharing / members

Yes (allowlist-gated)

Sharing, role updates, content_item_list_roles for the read side and user_search_organization_users to find people; no member CRUD

Export

Yes (PDF/SVG)

No

Current user

Derived from board owner

Yes (user_who_am_i)

MCP Resources

3

No

MCP Prompts

5 workflows

Bundled agent skills (browse, code-review, diagram, doc, table)

Runtime

Single Go binary

Hosted (closed-source)

Rate limiting

Adaptive

N/A (hosted)

Caching

Built-in (2min TTL)

N/A

Metrics

Prometheus

No

OpenTelemetry

Built-in (mcp-otel-go, OTel Registry)

No

Where the differences come from. Spaces, sections and canvas-SVG have no endpoints in the public REST API v2 — checked 13-08-2026 against the 114-path OpenAPI spec tracked in api-tracking/, and re-checked by probing the live API, since the spec omits endpoints Miro does ship. Those run on Miro-internal APIs. The reverse also holds: mindmaps, tags, groups, connectors and export are public REST surfaces the official server has not wrapped.

Board context used to be a design difference rather than a gap, and as of 18-09-2026 it is neither: context_get returned a server-side AI summary of a board and has been removed along with context_explore. miro_get_board_content returns the structured content itself — items by type, frame hierarchy, connectors and tags — and lets the model already in your session do the summarizing, with no second inference hop.

When to use the official server: You want zero-setup via plugin marketplace, OAuth 2.1 enterprise security, spaces and sections, comments, SVG workflows, search across all your Miro content, narrated boardcasts, or your organization's brand styling. Board context extraction is no longer among them — those tools were removed on 18-09-2026.

When to use this server: You need full REST coverage (110 tools, or a tunable 15-tool essentials mode), offline/self-hosted operation, richer board listing metadata, bulk ops, mindmaps, tags, connectors, or export.

Both can coexist — use different MCP server names in your config.


Performance

  • Caching: 2-minute TTL reduces API calls

  • Rate limiting: Adapts to Miro's rate limit headers

  • Circuit breaker: Isolates failing endpoints

  • Parallel bulk ops: Creates items concurrently

  • Token validation: Fails fast on startup with clear error

  • Transient error retry: Auto-retries 502/503/504 with backoff

  • OpenTelemetry: Built-in tracing and metrics via mcp-otel-go (OTel Registry)

See PERFORMANCE.md for optimization tips and benchmarks.


HTTP Mode Endpoints

When running with -http :8080:

Endpoint

Description

/

MCP protocol (Streamable HTTP)

/health

Health check (JSON)

/health?deep=true

Deep health check (tests Miro API)

/metrics

Prometheus metrics

/.well-known/mcp-server-card

SEP-2127 Server Card (JSON) via mcp-servercard-go

Health check response:

{
  "status": "healthy",
  "server": "miro-mcp-server",
  "version": "1.21.0",
  "uptime": "2h30m",
  "components": {
    "config": {"status": "healthy"},
    "miro_api": {"status": "healthy", "latency": "145ms"}
  }
}

Development

# Build
make build

# Run tests
make test

# Run with coverage
make test-cover

# Lint
make lint

# Build for all platforms
make build-all

# See all targets
make help

Docker Deployment

Quick start:

# Using Docker Compose
export MIRO_ACCESS_TOKEN=your-token
docker compose up -d

# Or build and run manually
docker build -t miro-mcp-server .
docker run -e MIRO_ACCESS_TOKEN=xxx -p 8080:8080 miro-mcp-server

docker-compose.yml features:

  • Health checks configured

  • Resource limits template

  • Environment variable passthrough


Debugging with MCP Inspector

Test and debug the server interactively with MCP Inspector:

# Install and run (no setup required)
npx @modelcontextprotocol/inspector miro-mcp-server

# With environment variables
MIRO_ACCESS_TOKEN=your-token npx @modelcontextprotocol/inspector miro-mcp-server

Open http://localhost:6274 to:

  • Browse all 110 tools with their schemas

  • Test tool calls interactively

  • View raw JSON-RPC messages

  • Debug parameter validation

See SETUP.md for more debugging options.


Supported Platforms

Platform

Binary

macOS (Apple Silicon)

miro-mcp-server-darwin-arm64

macOS (Intel)

miro-mcp-server-darwin-amd64

Linux (x64)

miro-mcp-server-linux-amd64

Linux (ARM64)

miro-mcp-server-linux-arm64

Windows (x64)

miro-mcp-server-windows-amd64.exe

Docker

ghcr.io/olgasafonova/miro-mcp-server


Supported AI Tools

Tool

Status

Claude Code

Tested

Claude Desktop

Tested

Cursor

Tested

VS Code + GitHub Copilot

Supported

Windsurf

Supported

Replit

Supported

Any MCP-compatible client

Supported

See SETUP.md for configuration guides.


Account Compatibility

Account Type

Support

Free

106 tools

Team

106 tools

Business

106 tools

Enterprise

All 110 tools

Four tools need an Enterprise plan and fail with a hint saying so: the three PDF/SVG export tools (miro_create_export_job, miro_get_export_job_status, miro_get_export_job_results) and miro_get_org_audit_logs, which additionally needs the auditlogs:read scope. miro_get_board_picture works on every plan. Everything else works on any plan.

The 6 code widget tools and 5 comment tools use Miro's v2-experimental API; availability may vary by account or plan, and the endpoints may change before GA.


Like This Project?

If this server saved you time, consider giving it a ⭐ on GitHub. It helps others discover the project.


More MCP Servers

Check out my other MCP servers:

Server

Description

Stars

gleif-mcp-server

Access GLEIF LEI database. Look up company identities, verify legal entities.

GitHub stars

mediawiki-mcp-server

Connect AI to any MediaWiki wiki. Search, read, edit wiki content.

GitHub stars

nordic-registry-mcp-server

Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden.

GitHub stars

productplan-mcp-server

Talk to your ProductPlan roadmaps. Query OKRs, ideas, launches.

GitHub stars

tilbudstrolden-mcp

Nordic grocery deal hunting. Find offers, plan meals, track spending.

GitHub stars

mcp-servercard-go

Go library for SEP-2127 Server Cards. Pre-connect discovery for MCP servers.

GitHub stars


License

MIT


Available Tools

88 tools
miro_attach_tagA

Attach an existing tag to a sticky note or card. The tag must already exist; create it first with miro_create_tag if needed. Only sticky_note and card items support tags.

USE WHEN: "tag this sticky as Urgent", "add the Done label", "mark this card with Priority"

FAILS WHEN: tag_id doesn't exist on this board (list with miro_list_tags), item is not a sticky_note or card.

VOICE-FRIENDLY: "Tagged sticky with 'Urgent'"

Inputs: tag_id (required), item_id (required), board_id (required). Returns: tag_id, item_id, message, success

miro_bulk_createA

Create multiple items at once (max 20). For creating only stickies in a grid, use miro_create_sticky_grid instead.

USE WHEN: "add these 5 stickies", "create items for each of these", "batch add"

VOICE-FRIENDLY: "Created 5 items on the board"

Inputs: items (required), board_id (required). Returns: errors, created, message, item_ids, +3 more

miro_bulk_deleteA
Destructive

Delete multiple items at once (max 20).

WARNING: Cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "Deleted 5 items from the board"

Inputs: board_id (required), item_ids (required), dry_run. Returns: errors, deleted, message, item_ids, +2 more

miro_bulk_updateA

Update multiple items at once (max 20). Only provide fields you want to change.

VOICE-FRIENDLY: "Updated 5 items on the board"

Inputs: items (required), board_id (required). Returns: errors, message, updated, item_ids, +2 more

miro_copy_boardA

Copy an existing Miro board.

VOICE-FRIENDLY: "Copied board to 'Sprint Planning Copy'"

Inputs: board_id (required), name, team_id, description. Returns: id, name, message, view_link

miro_create_app_cardA

Create an app card with custom fields and status indicators. For simple cards with due dates, use miro_create_card instead.

USE WHEN: "create an app card", "add a card with fields", "create a custom card"

VOICE-FRIENDLY: "Created app card 'Integration Status'"

Inputs: title (required), board_id (required), x, y, +5 more. Returns: id, title, status, message, +2 more

miro_create_boardB

Create a new Miro board.

VOICE-FRIENDLY: "Created board 'Sprint Planning'"

Inputs: name (required), team_id, description. Returns: id, name, message, view_link

miro_create_cardA

Create a card on a Miro board. Cards have title, description, and due dates. For cards with custom fields and status, use miro_create_app_card.

USE WHEN: "add a card", "create a task card", "card with due date"

VOICE-FRIENDLY: "Created card 'Review design specs'"

Inputs: title (required), board_id (required), x, y, +4 more. Returns: id, title, message, item_url

miro_create_connectorA

Create a connector line between two items. Styles: straight, elbowed (default), curved. Caps: none, arrow, stealth, diamond, filled_diamond, oval, filled_oval, triangle, filled_triangle.

Inputs: board_id (required), end_item_id (required), start_item_id (required), style, +3 more. Returns: id, message, item_url

miro_create_docA

Create a rich text document on a Miro board from Markdown content.

USE WHEN: User says "add a document", "create a doc from markdown", "put markdown on the board"

PARAMETERS:

  • board_id: Required

  • content: Markdown text (required). Supports headings, lists, bold, italic, links, code blocks.

  • x, y: Position

  • parent_id: Frame ID to place doc in

EXAMPLE: {"board_id": "uXjVN1234", "content": "# Sprint Goals\n- Ship v2.0\n- Fix critical bugs"}

RELATED: Use miro_get_doc to read doc content. Use miro_delete_doc to remove. For URL-based documents, use miro_create_document instead.

VOICE-FRIENDLY: "Created doc format item on board"

Inputs: content (required), board_id (required), x, y, +1 more. Returns: id, message, item_url

miro_create_documentA

Add a document (PDF, etc.) to a Miro board from a URL. URL must be publicly accessible.

RELATED: To upload a local file instead, use miro_upload_document.

Inputs: url (required), board_id (required), x, y, +3 more. Returns: id, title, message, item_url

miro_create_embedA

Embed external content as a live preview on a Miro board. Supports YouTube, Vimeo, Figma, Google Docs, Loom, and other oEmbed providers. For static images from URL, use miro_create_image. For document references from URL, use miro_create_document.

USE WHEN: "embed this YouTube video", "add a Figma link", "embed Google Doc", "put a Loom video on the board"

Inputs: url (required), board_id (required), x, y, +4 more. Returns: id, url, message, item_url, +1 more

miro_create_export_jobA

Export boards to PDF, SVG, or HTML. ENTERPRISE ONLY. Returns job ID; use miro_get_export_job_status to monitor.

Inputs: org_id (required), board_ids (required), format, request_id. Returns: job_id, status, message, request_id

miro_create_flowchart_shapeA

Create a flowchart shape using the experimental API. Supports additional stencil shapes beyond the standard shape tool.

USE WHEN: User says "create a flowchart shape", "add a process box", "draw a decision diamond for flowchart"

For standard shapes, use miro_create_shape instead. This tool uses the v2-experimental API for flowchart-specific stencil shapes.

PARAMETERS:

  • board_id: Required

  • shape: Shape type (required). Supports: rectangle, round_rectangle, circle, rhombus, parallelogram, trapezoid, pentagon, hexagon, star, flow_chart_predefined_process, wedge_round_rectangle_callout, etc.

  • content: Text inside the shape

  • x, y: Position

  • width, height: Size (default 200x200)

  • fill_color: Fill color (hex like #006400)

  • border_color: Border color (hex like #000000)

  • parent_id: Frame ID

NOTE: Uses v2-experimental API. Shape types may change when this moves to GA.

Inputs: shape (required), board_id (required), x, y, +6 more. Returns: id, shape, content, message, +1 more

miro_create_frameA

Create a frame container to group items visually. For logical grouping without a visual border, use miro_create_group.

Inputs: board_id (required), x, y, color, +3 more. Returns: id, title, message, item_url

miro_create_groupA

Group multiple items together logically (minimum 2). Grouped items move and resize together. For a visible container with a border and title, use miro_create_frame.

VOICE-FRIENDLY: "Grouped 4 items together"

Inputs: board_id (required), item_ids (required). Returns: id, message, item_ids, item_url, +1 more

miro_create_imageA

Add an image to a Miro board from a URL.

USE WHEN: User says "add an image", "insert picture from URL", "put this image on the board"

PARAMETERS:

  • board_id: Required

  • url: Image URL (must be publicly accessible, required)

  • title: Alt text / title

  • width: Image width (preserves aspect ratio)

  • x, y: Position

NOTE: The image URL must be publicly accessible. Private URLs won't work.

RELATED: To upload a local file instead, use miro_upload_image.

Inputs: url (required), board_id (required), x, y, +3 more. Returns: id, url, title, message, +1 more

miro_create_mindmap_nodeA

Create a mindmap node. Omit parent_id for root; add parent_id for children. node_view: "text" (default) or "bubble".

Inputs: content (required), board_id (required), x, y, +2 more. Returns: id, content, message, item_url, +1 more

miro_create_shapeA

Create a shape on a Miro board.

USE WHEN: User says "add a rectangle", "draw a circle", "create a box for X"

SHAPE TYPES:

  • Basic: rectangle, round_rectangle, circle, triangle, rhombus

  • Flow: parallelogram, trapezoid, pentagon, hexagon, star

  • Flowchart: flow_chart_predefined_process, wedge_round_rectangle_callout

PARAMETERS:

  • board_id: Required. Get from list_boards or find_board

  • shape: Shape type (required, default: rectangle)

  • content: Text inside shape

  • color: Fill color (e.g., "#FF5733" or color name)

  • x, y: Position (default: 0, 0)

  • width, height: Size (default: 200, 200)

RETURNS: Item ID, shape type, position, size, and view link.

RELATED: For flowchart-specific stencil shapes (experimental API), use miro_create_flowchart_shape instead.

EXAMPLE: {"board_id": "uXjVN1234", "shape": "circle", "content": "Start", "color": "green", "x": 0, "y": 0}

Inputs: shape (required), board_id (required), x, y, +6 more. Returns: id, shape, content, message, +1 more

miro_create_stickyA

Create a sticky note on a Miro board. For multiple stickies in a grid, use miro_create_sticky_grid. For batch creation of mixed items, use miro_bulk_create.

USE WHEN: "add a sticky", "create note saying X", "put a yellow sticky"

VOICE-FRIENDLY: "Created yellow sticky 'Action item: Review design'"

Inputs: content (required), board_id (required), x, y, +3 more. Returns: id, color, content, message, +1 more

miro_create_sticky_gridA

Create multiple sticky notes arranged in a grid layout (max 50). For mixed item types, use miro_bulk_create.

USE WHEN: "add a grid of stickies", "create 6 stickies in rows", "make sticky notes for each idea"

VOICE-FRIENDLY: "Created 9 stickies in a 3x3 grid"

Inputs: board_id (required), contents (required), color, columns, +4 more. Returns: rows, columns, created, message, +2 more

miro_create_tagB

Create a tag on a Miro board. Colors: red, magenta, violet, blue, cyan, green, yellow, gray, light_green, dark_green, dark_blue, dark_gray, black.

VOICE-FRIENDLY: "Created red tag 'Urgent'"

Inputs: title (required), board_id (required), color. Returns: id, color, title, message, +1 more

miro_create_textA

Add free-floating text to a Miro board with no background or border. For notes with colored backgrounds, use miro_create_sticky. For rich Markdown documents, use miro_create_doc.

USE WHEN: "add a title", "put heading text", "write a label", "add text saying X"

Inputs: content (required), board_id (required), x, y, +4 more. Returns: id, content, message, item_url

miro_delete_app_cardA
Destructive

Delete an app card from a Miro board.

WARNING: Cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "App card deleted successfully"

Inputs: item_id (required), board_id (required), dry_run. Returns: item_id, message, success

miro_delete_boardA
Destructive

Delete a Miro board permanently.

WARNING: Cannot be undone. Use dry_run=true to preview first.

Inputs: board_id (required), dry_run. Returns: message, success, board_id

miro_delete_connectorA
Destructive

Delete a connector from a Miro board.

WARNING: Cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "Connector deleted successfully"

Inputs: board_id (required), connector_id (required), dry_run. Returns: id, message, success

miro_delete_docA
Destructive

Delete a doc format item from a Miro board.

USE WHEN: User says "remove the document", "delete that doc"

PARAMETERS:

  • board_id: Required

  • item_id: Doc format item ID to delete (required)

  • dry_run: If true, returns preview without deleting (optional)

WARNING: This action cannot be undone. Use dry_run=true to preview what will be deleted before executing.

RELATED: Use miro_get_doc to inspect before deleting. Use miro_create_doc to create new documents.

Inputs: item_id (required), board_id (required), dry_run. Returns: item_id, message, success

miro_delete_frameA
Destructive

Delete a frame from a Miro board. Items inside are NOT deleted; they become ungrouped.

WARNING: Cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "Frame deleted successfully"

Inputs: board_id (required), frame_id (required), dry_run. Returns: id, message, success

miro_delete_groupA
Destructive

Delete a group. Set delete_items=true to also delete items (default: items are released to move independently).

USE WHEN: deleting a group OR ungrouping items. With delete_items=false (default), items are ungrouped and remain on the board. With delete_items=true, both the group and its items are permanently deleted.

WARNING: Deleting items (delete_items=true) cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "Group deleted, items ungrouped"

Inputs: board_id (required), group_id (required), dry_run, delete_items. Returns: message, success, group_id

miro_delete_itemA
Destructive

Delete an item from a Miro board.

WARNING: Cannot be undone. Use dry_run=true to preview first.

Inputs: item_id (required), board_id (required), dry_run. Returns: item_id, message, success

miro_delete_mindmap_nodeA
Destructive

Delete a mindmap node. Deleting a parent may affect children. Uses v2-experimental API.

WARNING: Cannot be undone. Use dry_run=true to preview first.

Inputs: node_id (required), board_id (required), dry_run. Returns: id, message, success

miro_delete_tagA
Destructive

Delete a tag from a board. Removes the tag from all items.

WARNING: Cannot be undone. Use dry_run=true to preview first.

VOICE-FRIENDLY: "Tag deleted successfully"

Inputs: tag_id (required), board_id (required), dry_run. Returns: tag_id, message, success

miro_detach_tagA

Remove a tag from a sticky note or card. The tag stays on the board for reuse; to delete it entirely, use miro_delete_tag.

USE WHEN: "remove the Urgent tag", "untag this card", "take off the Done label"

Inputs: tag_id (required), item_id (required), board_id (required). Returns: tag_id, item_id, message, success

miro_find_boardA
Read-only

Find a Miro board by name (case-insensitive, partial match). Returns board ID for subsequent operations. For listing all boards, use miro_list_boards.

USE WHEN: "find board named X", "get the Design Sprint board"

VOICE-FRIENDLY: "Found 'Design Sprint' board - ready to work on it"

Inputs: name (required). Returns: id, name, message, view_link, +1 more

miro_generate_diagramA

Generate diagram on Miro from Mermaid code. Creates shapes and connectors with auto-layout.

USE WHEN: "create flowchart", "generate diagram", "draw process flow", "sequence diagram"

TYPES: flowchart/graph, sequenceDiagram FLOWCHART: A[rect] --> B{diamond} -->|label| C((circle)) SEQUENCE: participant A; A->>B: sync; A-->>B: async

Inputs: diagram (required), board_id (required), start_x, start_y, +4 more. Returns: message, node_ids, frame_ids, node_urls, +13 more

miro_get_app_cardB
Read-only

Get details of a specific app card by ID.

VOICE-FRIENDLY: "App card 'API Status' shows 3 custom fields"

Inputs: item_id (required), board_id (required). Returns: id, title, fields, status, +6 more

miro_get_audit_logA
Read-only

Query local audit log for MCP tool executions (this session only). Filter by time range, tool, board, action type, or success/failure.

Inputs: tool, limit, since, until, +3 more. Returns: total, events, message, has_more

miro_get_boardA
Read-only

Get board metadata: name, description, owner, creation date, and sharing policy.

USE WHEN: "who owns this board?", "when was this board created?", "board settings", "tell me about this board"

NOT FOR: Board content overview with item counts (use miro_get_board_summary). Full content export for AI analysis (use miro_get_board_content).

PARAMETERS:

  • board_id: Required. Get from miro_list_boards or miro_find_board.

RETURNS: Board name, description, owner info, creation/modification timestamps, sharing policy, and view link.

VOICE-FRIENDLY: "Board 'Sprint Planning' owned by Jane, created Jan 15"

Inputs: board_id (required). Returns: id, name, team, owner, +6 more

miro_get_board_contentA
Read-only

Get all board content for AI analysis and documentation generation. Returns items by type, frame hierarchy, connectors, and tags. For a quick summary, use miro_get_board_summary instead.

USE WHEN: "analyze this board", "generate documentation from board", "describe everything on this board"

VOICE-FRIENDLY: "Retrieved full content for 'Design Sprint': 26 items across 3 frames, 5 connectors, 2 tags"

Inputs: board_id (required), max_items, include_tags, include_connectors. Returns: id, name, tags, frames, +11 more

miro_get_board_memberA
Read-only

Get details of a specific board member.

VOICE-FRIENDLY: "John Smith has editor access"

Inputs: board_id (required), member_id (required). Returns: id, name, role, email, +1 more

miro_get_board_pictureA
Read-only

Get the preview image URL for a board. Works for all Miro plans. For full PDF/SVG exports, use the Enterprise export tools.

VOICE-FRIENDLY: "Got preview image for the board"

Inputs: board_id (required). Returns: message, board_id, image_url

miro_get_board_summaryA
Read-only

Get board overview with item counts and statistics. For full content export, use miro_get_board_content instead.

USE WHEN: "summarize this board", "board stats", "what's the overview"

VOICE-FRIENDLY: "Design Sprint has 15 stickies, 8 shapes, and 3 frames - 26 items total"

Inputs: board_id (required). Returns: id, name, message, view_link, +4 more

miro_get_connectorA
Read-only

Get full details of a specific connector by ID.

VOICE-FRIENDLY: "This connector links Item A to Item B with a curved arrow"

Inputs: board_id (required), connector_id (required). Returns: id, color, style, caption, +9 more

miro_get_desire_pathsA
Read-only

Query desire path normalizations. Shows what agents tried to send and how it was auto-corrected (URLs in ID fields, camelCase keys, string numbers, etc.). USE WHEN reviewing tool usage patterns to improve descriptions or schemas.

Filter by tool name or normalizer rule. Returns top patterns and recent events.

Inputs: rule, tool, limit. Returns: by_rule, by_tool, message, by_param, +3 more

miro_get_docA
Read-only

Get details of a doc format item by ID.

USE WHEN: User asks "show me that document", "what's in this doc", "read the document"

PARAMETERS:

  • board_id: Required

  • item_id: Doc format item ID (required)

RETURNS: Document content (Markdown), position, timestamps.

RELATED: Use miro_create_doc to create new documents. Use miro_delete_doc to remove.

Inputs: item_id (required), board_id (required). Returns: x, y, id, content, +5 more

miro_get_documentA
Read-only

Get details of a document on a Miro board, including its Miro-hosted URL and title. For image items, use miro_get_image instead.

USE WHEN: "get document details", "what document is this", "document URL"

VOICE-FRIENDLY: "Document 'Q4 Report' hosted at Miro"

Inputs: item_id (required), board_id (required). Returns: x, y, id, title, +5 more

miro_get_export_job_resultsA
Read-only

Get download links for completed export. ENTERPRISE ONLY. Links expire in 15 min; call again to regenerate.

Inputs: job_id (required), org_id (required). Returns: boards, job_id, status, message, +1 more

miro_get_export_job_statusA
Read-only

Check export job progress. ENTERPRISE ONLY.

Inputs: job_id (required), org_id (required). Returns: job_id, status, message, progress, +4 more

miro_get_frameA
Read-only

Get full details of a specific frame by ID. To get items inside the frame, use miro_get_frame_items.

VOICE-FRIENDLY: "Frame 'Sprint Planning' is 800x600 with 12 items inside"

Inputs: board_id (required), frame_id (required). Returns: x, y, id, color, +9 more

miro_get_frame_itemsA
Read-only

Get all items contained within a specific frame. Filterable by type. For items in a logical group, use miro_get_group_items.

VOICE-FRIENDLY: "Frame has 8 items: 5 stickies, 2 shapes, 1 text"

Inputs: board_id (required), frame_id (required), type, limit, +2 more. Returns: count, items, cursor, message, +1 more

miro_get_groupA
Read-only

Get details of a specific group by ID.

VOICE-FRIENDLY: "This group contains 4 items"

Inputs: board_id (required), group_id (required). Returns: id, items, message

miro_get_group_itemsA
Read-only

Get items in a group with their details. For items inside a visual frame, use miro_get_frame_items.

VOICE-FRIENDLY: "Group has 4 items: 2 stickies, 1 shape, 1 text"

Inputs: board_id (required), group_id (required), limit, cursor. Returns: count, items, message, has_more

miro_get_imageA
Read-only

Get details of an image on a Miro board, including its Miro-hosted URL, title, and dimensions. Use the image_url to download or reference the image. For document items, use miro_get_document instead.

USE WHEN: "get image URL", "what image is this", "image details"

VOICE-FRIENDLY: "Image 'Logo' is 800x600 at position (100, 200)"

Inputs: item_id (required), board_id (required). Returns: x, y, id, title, +5 more

miro_get_itemA
Read-only

Get full details of a specific item by ID. If you don't have the item ID, use miro_search_board to find it or miro_list_items to browse.

VOICE-FRIENDLY: "That sticky says 'Review Q4 goals' and was created by John yesterday"

Inputs: item_id (required), board_id (required). Returns: x, y, id, type, +11 more

miro_get_items_by_tagA
Read-only

Get all items on a board that have a specific tag attached.

USE WHEN: User asks "show items tagged Urgent", "what's labeled Done", "find all items with this tag"

PARAMETERS:

  • board_id: Required

  • tag_id: Tag ID to filter by (required). Get tag IDs from list_tags.

  • limit: Max items (default 50, max 50)

  • offset: Pagination offset

RETURNS: List of items with IDs, types, and content that have the specified tag.

RELATED: Use miro_list_tags to get tag IDs. Use miro_get_item_tags for the reverse lookup (tags on a specific item). Use miro_attach_tag / miro_detach_tag to manage tag assignments.

VOICE-FRIENDLY: "Found 7 items tagged 'Urgent'"

Inputs: tag_id (required), board_id (required), limit, offset. Returns: count, items, tag_id, message, +1 more

miro_get_item_tagsA
Read-only

List tags attached to a specific item.

USE WHEN: User asks "what tags are on this sticky", "show labels for this item"

PARAMETERS:

  • board_id: Required

  • item_id: Item ID (required)

RETURNS: List of tags attached to the item.

RELATED: For the reverse lookup (all items with a specific tag), use miro_get_items_by_tag.

Inputs: item_id (required), board_id (required). Returns: tags, count, item_id, message

miro_get_mindmap_nodeA
Read-only

Get mindmap node details including content, hierarchy, and position. Uses v2-experimental API.

Inputs: node_id (required), board_id (required). Returns: x, y, id, content, +7 more

miro_get_tagA
Read-only

Get details of a specific tag by ID.

VOICE-FRIENDLY: "Tag 'Urgent' is red"

Inputs: tag_id (required), board_id (required). Returns: id, color, title, message

miro_list_all_itemsA
Read-only

Retrieve ALL items from a board with automatic pagination (up to 10000). For quick lookups (max 50), use miro_list_items instead.

USE WHEN: "get everything on board", "list all items", "export board contents"

VOICE-FRIENDLY: "Retrieved 847 items in 9 pages"

Inputs: board_id (required), type, max_items, detail_level. Returns: count, items, message, truncated, +1 more

miro_list_board_membersA
Read-only

List all users who have access to a board.

VOICE-FRIENDLY: "This board has 5 members: 2 editors, 3 viewers"

Inputs: board_id (required), limit, offset. Returns: count, members, message, has_more

miro_list_boardsA
Read-only

List Miro boards accessible to the user. Use board ID for subsequent operations. For a specific board by name, use miro_find_board instead.

VOICE-FRIENDLY: "Found 5 boards: Design Sprint, Product Roadmap, Team Retro..."

Inputs: limit, query, offset, team_id. Returns: count, boards, offset, has_more

miro_list_connectorsB
Read-only

List all connectors (lines/arrows) on a Miro board.

VOICE-FRIENDLY: "Found 12 connectors on the board"

Inputs: board_id (required), limit, cursor. Returns: count, cursor, message, has_more, +1 more

miro_list_groupsA
Read-only

List all groups on a Miro board.

VOICE-FRIENDLY: "Found 3 groups on the board"

Inputs: board_id (required), limit, cursor. Returns: count, cursor, groups, message, +1 more

miro_list_itemsA
Read-only

List items on a Miro board (max 50). For ALL items with auto-pagination, use miro_list_all_items. For text search, use miro_search_board.

USE WHEN: "what's on the board", "show all stickies", "list shapes"

Inputs: board_id (required), type, limit, cursor, +1 more. Returns: count, items, cursor, has_more

miro_list_mindmap_nodesA
Read-only

List all mindmap nodes on a board. Returns flat list; use parent_id to reconstruct hierarchy. Uses v2-experimental API.

Inputs: board_id (required), limit, cursor. Returns: count, nodes, cursor, message, +1 more

miro_list_tagsA
Read-only

List all tag definitions on a board with IDs, titles, and colors. Use tag IDs from this response with miro_attach_tag, miro_detach_tag, and miro_get_items_by_tag.

USE WHEN: "show all tags", "what tags exist", "list labels", or before attaching a tag to get its ID

VOICE-FRIENDLY: "Board has 8 tags: Urgent (red), Done (green), Review (blue)..."

Inputs: board_id (required), limit. Returns: tags, count, message

miro_remove_board_memberA
Destructive

Remove a member from a board.

WARNING: This revokes the member's access to the board.

VOICE-FRIENDLY: "Removed member from board"

Inputs: board_id (required), member_id (required). Returns: message, success, member_id

miro_search_boardA
Read-only

Search for items containing specific text on a board (case-insensitive). For listing without search, use miro_list_items.

USE WHEN: "find items about X", "search for budget", "which stickies mention deadline"

VOICE-FRIENDLY: "Found 3 stickies mentioning 'budget'"

Inputs: query (required), board_id (required), type, limit. Returns: count, query, matches, message

miro_share_boardA

Share a board with someone by email. Roles: viewer (default), commenter, editor.

VOICE-FRIENDLY: "Shared board with jane@example.com as editor"

Inputs: email (required), board_id (required), role, message. Returns: role, email, message, success

miro_update_app_cardC

Update an app card's title, description, status, or custom fields.

VOICE-FRIENDLY: "Updated app card status to 'connected'"

Inputs: item_id (required), board_id (required), x, y, +5 more. Returns: id, title, status, message

miro_update_boardA
Idempotent

Update a Miro board's name or description. At least one field must be provided.

VOICE-FRIENDLY: "Updated board name to 'Sprint Planning Q1'"

Inputs: board_id (required), name, description. Returns: id, name, message, view_link, +1 more

miro_update_board_memberA
Idempotent

Update a board member's role (viewer, commenter, or editor).

VOICE-FRIENDLY: "Updated John's role to editor"

Inputs: role (required), board_id (required), member_id (required). Returns: id, name, role, email, +1 more

miro_update_cardC
Idempotent

Update a card (title, description, due_date, position).

VOICE-FRIENDLY: "Updated card title to 'Review PR'"

Inputs: item_id (required), board_id (required), x, y, +5 more. Returns: id, title, message, due_date, +1 more

miro_update_connectorA
Idempotent

Update a connector's style (straight/elbowed/curved), caps, caption, or color.

Inputs: board_id (required), connector_id (required), color, style, +3 more. Returns: id, message, success

miro_update_documentB
Idempotent

Update a document (title, url, position, width).

VOICE-FRIENDLY: "Updated document title"

Inputs: item_id (required), board_id (required), x, y, +4 more. Returns: id, title, message

miro_update_document_from_fileA

Replace the file on an existing document item with a new local document file.

USE WHEN: User says "replace this document", "update the PDF", "swap the file on this document". Use this to change the file on an existing document item without creating a new one. For updating metadata only (title, position), use miro_update_document instead.

PARAMETERS:

  • board_id: Required

  • item_id: Required. The existing document item to update.

  • file_path: Absolute path to the new document file (required). Supports: pdf, doc, docx, ppt, pptx, xls, xlsx, txt, rtf, csv. Max 6 MB.

  • title: New document title

  • x, y: New position

  • parent_id: Frame ID to move document into

NOTE: The item must already exist as a document. The file must exist on the local filesystem.

RELATED: To create a new document from file, use miro_upload_document. To update metadata only, use miro_update_document.

VOICE-FRIENDLY: "Replaced document file on item"

Inputs: item_id (required), board_id (required), file_path (required), x, +3 more. Returns: id, title, message, item_url

miro_update_embedC
Idempotent

Update an embed (url, mode: inline/modal, dimensions, position).

VOICE-FRIENDLY: "Updated embed settings"

Inputs: item_id (required), board_id (required), x, y, +5 more. Returns: id, url, message, provider

miro_update_frameA
Idempotent

Update a frame's title, position, size, or color. At least one field must be provided.

VOICE-FRIENDLY: "Updated frame title to 'Q1 Goals'"

Inputs: board_id (required), frame_id (required), x, y, +4 more. Returns: id, message, success

miro_update_groupA
Idempotent

Update a group's member items. Replaces all members; include existing IDs to keep them. Minimum 2 items.

VOICE-FRIENDLY: "Updated group with 5 items"

Inputs: board_id (required), group_id (required), item_ids (required). Returns: id, message, item_ids

miro_update_imageC
Idempotent

Update an image (title, url, position, width).

VOICE-FRIENDLY: "Updated image title to 'Logo'"

Inputs: item_id (required), board_id (required), x, y, +4 more. Returns: id, url, title, message

miro_update_image_from_fileA

Replace the file on an existing image item with a new local image file.

USE WHEN: User says "replace this image", "swap the screenshot", "update the image file". Use this to change the file on an existing image item without creating a new one. For updating metadata only (title, position), use miro_update_image instead.

PARAMETERS:

  • board_id: Required

  • item_id: Required. The existing image item to update.

  • file_path: Absolute path to the new image file (required). Supports: png, jpg, jpeg, gif, webp, svg.

  • title: New image title/alt text

  • x, y: New position

  • parent_id: Frame ID to move image into

NOTE: The item must already exist as an image. The file must exist on the local filesystem.

RELATED: To create a new image from file, use miro_upload_image. To update metadata only, use miro_update_image.

VOICE-FRIENDLY: "Replaced image file on item"

Inputs: item_id (required), board_id (required), file_path (required), x, +3 more. Returns: id, title, message, item_url

miro_update_itemA
Idempotent

Update any item's content, position, or style. For sticky-specific options (color, shape), use miro_update_sticky. For card fields, use miro_update_card. For shape styling, use miro_update_shape.

USE WHEN: "change sticky text", "move this item", "update the color"

Inputs: item_id (required), board_id (required), x, y, +5 more. Returns: item_id, message, success

miro_update_shapeA
Idempotent

Update a shape with type-specific options (fill_color, text_color, shape type). For generic updates, use miro_update_item.

VOICE-FRIENDLY: "Updated shape to blue circle"

Inputs: item_id (required), board_id (required), x, y, +7 more. Returns: id, content, message, shape_type

miro_update_stickyA
Idempotent

Update a sticky note with type-specific options (shape: square/rectangle, sticky colors). For generic updates, use miro_update_item.

USE WHEN: "change sticky color", "update sticky to square", "resize sticky note"

VOICE-FRIENDLY: "Updated sticky to yellow square"

Inputs: item_id (required), board_id (required), x, y, +5 more. Returns: id, color, shape, content, +1 more

miro_update_tagA
Idempotent

Update a tag's title or color. At least one must be provided.

VOICE-FRIENDLY: "Updated tag to 'Done' with green color"

Inputs: tag_id (required), board_id (required), color, title. Returns: id, color, title, message, +1 more

miro_update_textB
Idempotent

Update a text element (content, font_size, color, position).

VOICE-FRIENDLY: "Updated text to 'New Title'"

Inputs: item_id (required), board_id (required), x, y, +6 more. Returns: id, content, message, font_size

miro_upload_documentA

Upload a local document file to a Miro board.

USE WHEN: User says "upload this document", "add PDF to board", "upload spreadsheet/presentation file". Use this for document files (pdf, doc, docx, ppt, pptx, xls, xlsx, txt, rtf, csv). For images (png, jpg, gif), use miro_upload_image instead.

PARAMETERS:

  • board_id: Required

  • file_path: Absolute path to the document file (required). Supports: pdf, doc, docx, ppt, pptx, xls, xlsx, txt, rtf, csv. Max 6 MB.

  • title: Document title

  • x, y: Position

  • parent_id: Frame ID to place document in

NOTE: The file must exist on the local filesystem. For remote documents, use miro_create_document with a URL instead.

RELATED: To upload a local image instead, use miro_upload_image.

VOICE-FRIENDLY: "Uploaded document 'report.pdf' to board"

Inputs: board_id (required), file_path (required), x, y, +2 more. Returns: id, title, message, item_url

miro_upload_imageA

Upload a local image file to a Miro board.

USE WHEN: User says "upload this image", "add screenshot to board", "upload png/jpg/gif/svg file". Use this for image files (png, jpg, gif, webp, svg). For documents (pdf, docx, pptx), use miro_upload_document instead.

PARAMETERS:

  • board_id: Required

  • file_path: Absolute path to the image file (required). Supports: png, jpg, jpeg, gif, webp, svg.

  • title: Image title/alt text

  • x, y: Position

  • parent_id: Frame ID to place image in

NOTE: The file must exist on the local filesystem. For remote images, use miro_create_image with a URL instead.

RELATED: To upload a document file (pdf, docx, etc.), use miro_upload_document.

VOICE-FRIENDLY: "Uploaded image 'screenshot.png' to board"

Inputs: board_id (required), file_path (required), x, y, +2 more. Returns: id, title, message, item_url

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 88 tools

    Disambiguation4/5

    Despite 88 tools, each has a very specific purpose and detailed descriptions clarify differences. Some overlap exists between similar creation tools (e.g., miro_create_doc vs miro_create_text), but the descriptions effectively guide selection. Overall, an agent can distinguish tools with reasonable confidence.

    Naming Consistency5/5

    All tools follow a consistent 'miro_verb_noun' snake_case pattern. This makes the tool set predictable and easy to navigate. There are no deviations or mixing of conventions.

    Tool Count1/5

    With 88 tools, the server is far beyond the typical well-scoped range of 3-15. This extreme number suggests over-fragmentation and could overwhelm agents, increasing selection complexity and cognitive load.

    Completeness5/5

    The server covers virtually all Miro board operations: CRUD for every item type, board management, member management, export, search, bulk operations, tagging, auditing, and diagram generation. No obvious gaps exist; the surface is fully featured for the domain.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers