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

Installation

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

{
  "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. We recommend using 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.

In Dev environment recommend adding https://github.com/miroapp/api-clients/blob/041de24ebf7955432b447d887ede066ad4c7e2c7/packages/generator/spec.json for reference.