📌Overview

Purpose: The MCP Miro Server serves as a bridge to connect and manipulate the MIRO Whiteboard Application through a Model Context Protocol.

Overview: This server enables users to perform various operations within the MIRO platform, such as creating stickies, manipulating boards, and executing bulk actions. With integration capabilities for applications like Claude, it enhances usability and functionality in collaborative environments.

Key Features:

• Board Manipulation: Allows users to read and modify board contents, facilitating dynamic updates and creativity during collaborative sessions.

• Sticky and Shape Creation: Users can easily create stickies and shapes, which are essential for effective visual organization and brainstorming on the MIRO board.

• Bulk Operations: Simplifies the process of creating multiple elements at once, saving time and improving workflow efficiency.

• OAuth Integration: The server can securely authenticate using an OAuth key, enhancing security and seamless integration.

---

mcp-miro MCP Server

A Model Context Protocol server to connect to the MIRO Whiteboard Application.

• Allows Board manipulation, sticky creation, bulk operations, and more.
• Pass your OAuth key as an Environment Variable or using the --token argument.
• Taking a photo of stickies and asking Claude to create MIRO equivalent works really well.

Installation

Installing via Smithery

To install MIRO Whiteboard Connector for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @llmindset/mcp-miro --client claude

Using mcp-get

You can install this package using mcp-get:

npx @michaellatman/mcp-get@latest install @llmindset/mcp-miro

Note: If you are using an old version of Windows PowerShell, you may need to run Set-ExecutionPolicy Bypass -Scope Process before this command.

Features

Resources

• Get Board Contents

Tools

• Create Sticky, Shape
• Read Board, Frame, Contents
• Bulk Create

Prompts

• Instruct on Board Coordinates, etc.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Configuration for Claude Desktop

To use with Claude Desktop, add the server config:

• On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

Example configuration:

{
  "mcpServers": {
    "mcp-miro": {
      "command": "/path/to/node-or-npx",
      "arguments": [
        "/path/to/mcp-miro/build/index.js",
        "--token",
        "MIRO-OAUTH-KEY"
      ]
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. It is recommended to use the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Additional Notes

For development, it is recommended to reference the Miro API spec.