miro-mcp-server
miro-mcp-server is an MCP server for controlling Miro boards from AI tools, covering board and item CRUD, diagrams, collaboration, and bulk operations.
Create, copy, update, delete, summarize, search, and inspect boards; list/share board members and manage roles.
Create, read, update, and delete Miro items including stickies, shapes, text, cards, app cards, frames, images, documents, docs, embeds, mindmap nodes, connectors, groups, and tags.
Generate flowcharts and sequence diagrams from Mermaid syntax and inspect native diagram items.
Organize content with frames, groups, tags, connectors, and mindmap parent-child relationships.
Bulk create/update/delete items and create sticky-note grids.
Upload local images/documents, replace existing files, add files from URLs, and retrieve Miro-hosted URLs.
Export board thumbnails and Enterprise PDF/SVG/HTML exports.
Use experimental comments, code widgets, tables, and SVG read/create/update workflows.
Query local audit logs and agent normalization reports, and discover tools via
miro_tool_search.
Supports embedding Figma designs and content directly onto Miro boards.
Supports creating, reading, and managing Markdown-based documents as native items on Miro boards.
Enables the generation of flowcharts and sequence diagrams on Miro boards from Mermaid syntax.
Provides comprehensive tools for managing Miro boards, including creating and organizing items such as stickies, shapes, frames, and cards, as well as managing board members and permissions.
Provides functionality to export Miro board content into SVG vector format.
Allows for embedding YouTube videos as interactive elements on Miro boards.
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
Documentation
Document | Description |
Get running in 2 minutes | |
Full setup for all AI tools | |
Configuration reference | |
Optimization guide | |
Version history | |
Error handling & troubleshooting |
Related MCP server: Miro MCP
Quick Start
1. Install
Homebrew (macOS/Linux):
brew tap olgasafonova/tap && brew install miro-mcp-serverOne-liner (macOS/Linux):
curl -fsSL https://raw.githubusercontent.com/olgasafonova/miro-mcp-server/main/install.sh | shDocker:
docker pull ghcr.io/olgasafonova/miro-mcp-server:latestManual download: See SETUP.md for all platforms
2. Get a Miro Token
Create an app with
boards:readandboards:writepermissionsInstall 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-serverClaude Desktop / Cursor / VS Code: See SETUP.md
Cursor Marketplace:
/add-plugin miroNot 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
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@latestCompanion 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 |
|
Visual board summaries, sticky color clusters, connector graphs rendered inline | |
Same in bash, CI, or a Makefile |
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.) |
| 110 | ~20,795 |
| 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 |
| List accessible boards with owner, team, and timestamps |
| Find board by name, with the same metadata as the listing |
| Get board details |
| Get board stats and item counts |
| Get all board content for AI analysis |
| Create a new board |
| Copy an existing board |
| Update board name/description |
| Delete a board |
Tool | Description |
| List users with access |
| Get member details |
| Share board via email (requires |
| Update member role (Destructive: prompts before role escalation) |
| Remove member from board |
Sharing and role-change tools are guarded for prompt-injection safety. See
SECURITY.mdandCONFIG.md.
Tool | Description |
| Create a sticky note |
| Create stickies in a grid layout |
| Create a shape (rectangle, circle, etc.) |
| Create flowchart shape (experimental API) |
| Create text element |
| Create a frame container |
| Create a card with due date |
| Create app card with custom fields |
| Add image from URL |
| Upload local image file |
| Upload local document file (PDF, DOCX, etc.) |
| Create Markdown document |
| Add document from URL |
| Embed YouTube, Figma, etc. |
| Connect two items with arrow |
| Group items together |
| Create mindmap node |
| Create multiple items at once |
Tool | Description |
| Get frame details |
| Update frame title/color/size |
| Delete a frame |
| List items inside a frame |
Tool | Description |
| Get node details |
| List all mindmap nodes |
| Delete a mindmap node |
Tool | Description |
| Add a syntax-highlighted code snippet |
| Get full source and settings |
| List widgets with code previews |
| Change code, language, title, or size |
| Move to a new position |
| Delete a code widget |
Tool | Description |
| Open a comment thread, optionally attached to an item |
| List threads with messages and resolved state |
| Get one thread with its full message history |
| Append a reply to a thread |
| Resolve a thread, or reopen with resolved=false |
Tool | Description |
| Render board items as an SVG document (computed locally); |
| Create items from SVG: shapes, text, stickies and frames ( |
| Apply an SVG diff keyed on |
Tool | Description |
| List items on a board |
| Get ALL items with auto-pagination |
| Get item details |
| Get image details and Miro-hosted URL |
| Get document details and Miro-hosted URL |
| Get app card details |
| Get Markdown document content |
| Search items by content |
| Introspect the access token: user, team, organization, application, scopes |
Tool | Description |
| Update item content/position/color |
| Update sticky note (shape, color) |
| Update shape (fill, text color, type) |
| Update text element |
| Update card fields |
| Update image properties |
| Replace image file on existing item |
| Update document properties |
| Replace document file on existing item |
| Update embed properties |
| Update group properties |
| Update app card fields |
| Update multiple items at once |
| Delete an item |
| Delete an app card |
| Update document content (full or find-and-replace) |
| Delete a Markdown document |
| Delete multiple items at once |
Tool | Description |
| Create a tag |
| List all tags on board |
| Get tag details by ID |
| Attach tag to item |
| Remove tag from item |
| Get tags on an item |
| Get all items with a specific tag |
| Update tag name/color |
| Delete a tag |
Tool | Description |
| List all connectors |
| Get connector details |
| Update connector style/caption |
| Delete a connector |
Tool | Description |
| List all groups on board |
| Get group details |
| List items in a group |
| Delete or ungroup a group |
Tool | Description |
| Get board thumbnail |
| Export to PDF/SVG (Enterprise) |
| Check export progress |
| Get download links |
Tool | Description |
| List tables (data_table_format) on a board |
| Get table metadata by ID |
Tool | Description |
| Find the right tool by keyword or category; registered in both profiles and the only gateway to the full surface in |
Tool | Description |
| Create diagram from Mermaid syntax |
| List native diagram items on a board |
| Get native diagram metadata by ID |
| Query THIS SERVER's local execution log |
| Query MIRO's org-wide audit log (Enterprise; |
| 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 --> BSequence 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 | 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 | None since 18-09-2026 ( |
AI context | No | None since 18-09-2026 ( |
Layout DSL | Composed from bulk create + the | None since 18-09-2026 — all four |
Canvas as SVG | Read + create + update ( | Yes (read, create, update from SVG). Reads scope to a rectangle or a |
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 ( |
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 ( |
Images | Create, upload, update from file | Create, upload URL, get data/URL |
Bulk operations | Yes | No ( |
Search | Within a board ( | Across boards, spaces and video call recordings, including text inside boards ( |
Narrated walkthroughs | No | Yes ( |
Brand context | No | Yes ( |
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, |
Export | Yes (PDF/SVG) | No |
Current user | Derived from board owner | Yes ( |
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 check (JSON) |
| Deep health check (tests Miro API) |
| Prometheus metrics |
| 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 helpDocker 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-serverdocker-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-serverOpen 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) |
|
macOS (Intel) |
|
Linux (x64) |
|
Linux (ARM64) |
|
Windows (x64) |
|
Docker |
|
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 |
Access GLEIF LEI database. Look up company identities, verify legal entities. | ||
Connect AI to any MediaWiki wiki. Search, read, edit wiki content. | ||
Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden. | ||
Talk to your ProductPlan roadmaps. Query OKRs, ideas, launches. | ||
Nordic grocery deal hunting. Find offers, plan meals, track spending. | ||
Go library for SEP-2127 Server Cards. Pre-connect discovery for MCP servers. |
License
MIT
Available Tools
88 toolsmiro_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_deleteADestructive
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_cardADestructive
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_boardADestructive
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_connectorADestructive
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_docADestructive
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_frameADestructive
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_groupADestructive
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_itemADestructive
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_nodeADestructive
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_tagADestructive
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_boardARead-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_cardBRead-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_logARead-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_boardARead-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_contentARead-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_memberARead-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_pictureARead-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_summaryARead-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_connectorARead-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_pathsARead-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_docARead-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_documentARead-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_resultsARead-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_statusARead-only
Check export job progress. ENTERPRISE ONLY.
Inputs: job_id (required), org_id (required). Returns: job_id, status, message, progress, +4 more
miro_get_frameARead-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_itemsARead-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_groupARead-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_itemsARead-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_imageARead-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_itemARead-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_tagARead-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_tagsARead-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_nodeARead-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_tagARead-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_itemsARead-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_membersARead-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_boardsARead-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_connectorsBRead-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_groupsARead-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_itemsARead-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_nodesARead-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_tagsARead-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_memberADestructive
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_boardARead-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_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_boardAIdempotent
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_memberAIdempotent
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_cardCIdempotent
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_connectorAIdempotent
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_documentBIdempotent
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_embedCIdempotent
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_frameAIdempotent
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_groupAIdempotent
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_imageCIdempotent
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_itemAIdempotent
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_shapeAIdempotent
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_stickyAIdempotent
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_tagAIdempotent
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_textBIdempotent
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
Scored across 88 tools
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.
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.
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.
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
Related MCP Connectors
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server to connect to the MIRO Whiteboard Application. Allows Board manipulation, sticky creation, bulk operations and more.44 npm113Apache 2.0
- AlicenseBqualityDmaintenanceMiro MCP server, exposing all functionalities available in official Miro SDK.97291 npm65Apache 2.0
- AlicenseAqualityAmaintenanceMCP server for MediaWiki wikis. Search, read, edit, and manage wiki content from AI assistants. Includes formatting, link checking, revision history, and markdown conversion.4324MIT
- AlicenseNot gradedqualityDmaintenanceThis repository contains an implementation of an Miro Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Miro's tools and services through a unified API.1MIT