miro-mcp-server

Overview

The miro-mcp-server provides extensive functionality for managing Miro whiteboards through MCP protocol. It offers 92 tools covering board management, item manipulation, diagram generation, document handling, and more. The server implements a token-efficient design with two profiles (full and essentials) to balance functionality and context usage. It includes companion workflow skills for common board layouts like sprint boards, retrospectives, and kanban boards. The project is well-maintained with regular updates and comprehensive documentation across multiple guides.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• miro_list_boards

  List accessible boards

  Try:What boards do I have?Try:Show me all my Miro boards
• miro_create_board

  Create a new board

  Try:Create a new board called 'Project Planning'Try:Make a brainstorming board
• miro_create_sticky

  Create a sticky note

  Try:Add a yellow sticky saying 'Review PRs'Try:Create a blue sticky with ideas
• miro_create_diagram

  Create diagram from Mermaid syntax

  Try:Create a flowchart: Start → Decision → EndTry:Make a sequence diagram with Alice and Bob
• miro_list_items

  List items on a board

  Try:What items are on the board?Try:Show me all stickies and shapes
• miro_search_board

  Search items by content

  Try:Find stickies with 'action' in themTry:Search for items about user feedback
• miro_update_item

  Update item content/position/color

  Try:Change the sticky color to redTry:Move the shape to the top right
• miro_create_connector

  Connect two items with arrow

  Try:Connect these two stickies with an arrowTry:Link the ideas together
• miro_share_board

  Share board via email

  Try:Share the Design board with jane@example.comTry:Give access to the project board
• miro_create_mindmap_node

  Create mindmap node

  Try:Create a mindmap with 'Project Ideas' as rootTry:Add a child node about features
• miro_bulk_create

  Create multiple items at once

  Try:Create three stickies with different colorsTry:Add multiple items in a grid layout
• miro_tool_search

  Search for available tools by name or category

  Try:What tools can create stickies?Try:Show me all board management tools

Comparable tools

Installation

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

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

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

{
  "mcpServers": {
    "miro": {
      "command": "miro-mcp-server",
      "args": []
    }
  }
}

export MIRO_ACCESS_TOKEN=your-token

FAQ

How do I get a Miro access 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.

Can I reduce token usage for large Miro boards?

Yes, set MIRO_TOOLS_PROFILE=essentials in your client config to use a curated 15-tool subset that reduces preload tokens by 84.5%.

Compare miro-mcp-server with