Miro
MCP server for controlling Miro whiteboards with AI assistants. Create and manage stickies, shapes, frames, connectors, and more.
What is Miro?
Miro is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for controlling miro whiteboards with ai assistants. create and manage stickies, shapes, frames, connectors, and more.
MCP server for controlling Miro whiteboards with AI assistants. Create and manage stickies, shapes, frames, connectors, and more.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for controlling Miro whiteboards with AI assistan
Use Cases
Maintainer
Works with
Installation
NPM
npx -y miroManual Installation
npx -y miroConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Miro
The Miro MCP server gives AI assistants full programmatic control over Miro whiteboards, exposing 92 tools that cover board management, sticky notes, shapes, frames, connectors, tags, mindmaps, and diagram generation from Mermaid syntax. It connects to Miro via a personal access token and allows Claude or other MCP clients to create, update, delete, and organize whiteboard content without manual interaction. Teams use it to automate diagramming workflows, generate visual artifacts from meeting notes or code architecture discussions, and manage collaborative boards at scale.
Prerequisites
- A Miro account with access to at least one workspace
- A Miro app access token with boards:read and boards:write permissions (from miro.com/app/settings/user-profile/apps)
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
- For Homebrew install: macOS or Linux with Homebrew installed; alternatively Docker for containerized deployment
Create a Miro app and get your access token
Navigate to miro.com/app/settings/user-profile/apps and create a new application. Grant it boards:read and boards:write scopes, install it to your team workspace, and copy the generated access token.
Install the miro-mcp-server binary
Install via Homebrew (recommended for macOS/Linux) or pull the Docker image for containerized environments.
# macOS/Linux via Homebrew
brew tap olgasafonova/tap && brew install miro-mcp-server
# Or via Docker
docker pull ghcr.io/olgasafonova/miro-mcp-server:latestAdd the server to Claude Code (quickest path)
Use the Claude Code CLI to register the Miro server with your access token in a single command.
claude mcp add miro -e MIRO_ACCESS_TOKEN=your-token -- miro-mcp-serverOr configure Claude Desktop manually
If using Claude Desktop, add the server entry to claude_desktop_config.json. Optionally set MIRO_TOOLS_PROFILE to 'essentials' to load only 15 core tools and reduce token overhead from ~15,500 to ~2,400 tokens.
{
"mcpServers": {
"miro": {
"command": "miro-mcp-server",
"env": {
"MIRO_ACCESS_TOKEN": "your-miro-access-token",
"MIRO_TOOLS_PROFILE": "essentials"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop or reload Claude Code. The Miro tools should appear. Ask Claude to list your boards to confirm the connection is working.
Miro Examples
Client configuration
Claude Desktop configuration using the installed miro-mcp-server binary with a Miro access token. Use the essentials profile when working with token-limited contexts.
{
"mcpServers": {
"miro": {
"command": "miro-mcp-server",
"env": {
"MIRO_ACCESS_TOKEN": "your-miro-access-token-here",
"MIRO_TOOLS_PROFILE": "essentials"
}
}
}
}Prompts to try
Example prompts that exercise Miro board creation, diagramming, and content management tools.
- "Create a new Miro board called 'Sprint Planning' and add sticky notes for our three top priorities"
- "Generate a flowchart on my board showing the user authentication flow: login → validate → session or error"
- "Add a frame labeled 'Architecture' and place three rectangles inside it for frontend, backend, and database"
- "Create a sequence diagram in Miro showing how our API handles a POST request through middleware to the database"
- "Search my boards for 'Q3 roadmap' and add a sticky note with today's date to mark it reviewed"Troubleshooting Miro
Authentication errors or 401 responses when calling Miro tools
Confirm the MIRO_ACCESS_TOKEN value is correct and that the Miro app has been installed to the correct workspace. Tokens are workspace-scoped, so a token from one workspace will not work on boards belonging to another.
Context window is consumed by too many Miro tool definitions
Set MIRO_TOOLS_PROFILE=essentials in the server environment to load only the 15 most-used tools (~2,400 tokens) instead of all 92 (~15,500 tokens).
Rate limit errors during bulk operations
The server has built-in rate-limit adaptation, circuit breakers, and retry logic for 502/503/504 errors. If you still hit limits, reduce the number of items in a single prompt — break large batch operations into smaller groups.
Frequently Asked Questions about Miro
What is Miro?
Miro is a Model Context Protocol (MCP) server that mcp server for controlling miro whiteboards with ai assistants. create and manage stickies, shapes, frames, connectors, and more. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Miro?
Install via npm with the command: npx -y miro. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Miro?
Miro works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Miro free to use?
Yes, Miro is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Miro Alternatives — Similar Communication Servers
Looking for alternatives to Miro? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Miro in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Miro?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.