Miro MCP Server

The Miro MCP Server is a high-performance tool developed in Go language, providing 77 tools to control Miro whiteboards, supporting AI integration, chart generation, bulk operations, etc. It runs through a single binary file and is compatible with all major AI tools and platforms.

Note-taking tools Developer tools #Whiteboard control #AI integration #Chart generation #Bulk operations .Go

rating : 2.5 points

downloads : 4.6K

update time : 2026-01-13

Open Site

What is Miro MCP Server?

Miro MCP Server is a bridge that connects AI assistants and Miro whiteboards. It allows you to use natural language instructions to enable AI assistants (such as Claude, Cursor, etc.) to directly operate your Miro whiteboard without manual clicking and dragging.

How to use Miro MCP Server?

Simply install this tool, configure the Miro access token, and then enable it in your preferred AI tool. After that, you can use natural language to tell the AI assistant what you want to do on the whiteboard.

Use cases

Suitable for scenarios that require visual collaboration, such as team collaboration, brainstorming, project planning, flowchart design, and mind map creation. Especially suitable for users who want to quickly transform their ideas into visual content but don't want to spend a lot of time on manual operations.

Main features

Whiteboard management

Create, copy, delete, and update whiteboards, and view whiteboard details and content

Element creation

Create various elements such as sticky notes, shapes, text, cards, images, documents, and embedded content

Chart generation

Automatically generate flowcharts and sequence diagrams using Mermaid syntax

Mind map

Create and manage mind map nodes, supporting parent-child relationships

Bulk operations

Create, update, or delete multiple elements at once to improve efficiency

Tag management

Create, attach, update, and delete tags to better organize content

Export features

Get whiteboard thumbnails and export them in PDF/SVG format (Enterprise Edition)

Collaboration features

Share whiteboards with team members and manage member permissions

Advantages

🚀 High performance: Single binary file, fast startup (about 50ms), and low memory usage (about 10MB)

🛠️ Comprehensive functionality: Provides 77 tools, covering most functions of the Miro API

📊 Intelligent charts: Built-in Mermaid parser, can generate charts from text descriptions

⚡ Bulk operations: Supports parallel creation of multiple elements to improve work efficiency

🔧 Stable and reliable: Built-in cache, rate limit, and circuit breaker mechanisms

📱 Cross-platform: Supports macOS, Linux, Windows, and Docker

🆓 Free to use: Supports Miro Free, Team, Business, and Enterprise editions

Limitations

🔌 Requires a Miro account: You must first create a Miro application and obtain an access token

📶 Network-dependent: Requires a stable network connection to access the Miro API

🎨 Visual limitations: AI operations may not be as precise as manual operations, especially for complex layouts

🔄 Real-time synchronization: Changes may take a few seconds to appear on the whiteboard

🔐 Permission limitations: Subject to Miro application permissions, some advanced features may require higher permissions

How to use

Install the tool

Choose the appropriate installation method according to your operating system

Get the Miro access token

Create an application on the Miro developer platform and obtain an access token

Configure the AI tool

Configure Miro MCP Server in the AI tool you are using

Start using

Use natural language to operate the Miro whiteboard in the AI assistant

Usage examples

Rapid brainstorming

Quickly record ideas and visualize them during team meetings

Project flowchart

Automatically generate a project flowchart from text descriptions

Mind map planning

Create a project mind map to help clarify ideas

Team collaboration

Quickly share the whiteboard and add collaborators

Frequently Asked Questions

Do I need to pay to use this tool?

Which AI tools are supported?

How do I get the Miro access token?

Is this tool secure?

What's the difference between this and the official Miro MCP Server?

What should I do if I encounter an error?

Related resources

Official GitHub repository

Source code, issue feedback, and the latest version

Quick start guide

A 2-minute quick start guide

Complete configuration documentation

Detailed configuration instructions for all AI tools

Miro developer platform

Create Miro applications and obtain access tokens

Model Context Protocol

Official documentation of the MCP protocol

Other MCP servers

Other MCP server projects by the author

🚀 Miro MCP Server

Control Miro whiteboards with AI. Built in Go for speed and simplicity.

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

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

🚀 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

Go to miro.com/app/settings/user-profile/apps
Create an app with boards:read and boards:write permissions
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

✨ Features

What You Can Do

Category	Examples
Boards	Create, copy, delete, update, share, list members
Items	Sticky notes, shapes, text, cards, app cards, frames
Diagrams	Generate flowcharts and sequence diagrams from Mermaid
Mindmaps	Create mindmap nodes with parent-child relationships
Bulk Ops	Create multiple items at once, sticky grids
Tags	Create, attach, update, and organize with tags
Groups	Group, ungroup, 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"

All 77 Tools

Board Management (9)

Tool	Description
`miro_list_boards`	List accessible boards
`miro_find_board`	Find board by name
`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

Board Members (5)

Tool	Description
`miro_list_board_members`	List users with access
`miro_get_board_member`	Get member details
`miro_share_board`	Share board via email
`miro_update_board_member`	Update member role
`miro_remove_board_member`	Remove member from board

Create Items (14)

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_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_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

Frames (4)

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

Mindmaps (4)

Tool	Description
`miro_create_mindmap_node`	Create mindmap node
`miro_get_mindmap_node`	Get node details
`miro_list_mindmap_nodes`	List all mindmap nodes
`miro_delete_mindmap_node`	Delete a mindmap node

Read Items (5)

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_app_card`	Get app card details
`miro_search_board`	Search items by content

Update & Delete Items (6)

Tool	Description
`miro_update_item`	Update item content/position/color
`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_bulk_delete`	Delete multiple items at once

Tags (8)

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_update_tag`	Update tag name/color
`miro_delete_tag`	Delete a tag

Connectors (4)

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

Groups (5)

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_ungroup`	Ungroup items
`miro_delete_group`	Delete a group

Export (4)

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

Diagrams & Audit (2)

Tool	Description
`miro_generate_diagram`	Create diagram from Mermaid syntax
`miro_get_audit_log`	Query local execution log

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.

📦 Installation

The installation process is described in the Quick Start section.

💻 Usage Examples

Diagram Generation Example

Create flowcharts and sequence diagrams from Mermaid syntax as shown below:

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

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

📚 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

🔧 Technical Details

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 has released an official MCP server (beta). Here's how they compare:

Feature	This Server	Official Miro MCP
Tools	77	~5 (beta)
Diagram generation	Mermaid syntax	AI-based
Bulk operations	Yes	No
Mindmaps	Yes	No
Tags & Groups	Yes	No
Export	Yes	No
Runtime	Single Go binary	Node.js
Rate limiting	Adaptive	Basic
Caching	Built-in	No
OAuth flow	Built-in CLI	Requires setup

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

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

Health check response:

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