mcp-miro

Provides MCP integration with MIRO Whiteboard, enabling board access, sticky creation, read/write operations, and bulk actions via token-based authentication.

typescript

101

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run the mcp-miro MCP Server to connect MIRO Whiteboard with the MCP framework, enabling board operations, sticky notes, bulk actions, and more. You can pass your OAuth token either through an environment variable or via a command argument when starting the server.

How to use

To use this MCP server, run it as a local stdio server and connect your MCP client to it. You will start the server process and pass your MIRO OAuth key so the server can authenticate with the MIRO application. The running server exposes endpoints and commands that your MCP client can invoke to manipulate boards, read content, create stickies, and perform bulk operations.

How to install

Prerequisites: you need Node.js and npm (or a compatible runtime) installed on your system.

Install via Smithery (automatic): run the following command in your terminal.

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

Install using mcp-get (recommended for MCP workflows): run the following command in your terminal.

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

If you are using an older Windows PowerShell version, you may need to set the execution policy before running the command.

Set-ExecutionPolicy Bypass -Scope Process

Configuration and run

To use Claude Desktop, add the MCP server configuration at your Claude Desktop configuration file. The following example shows how to configure the mcp-miro server for stdio operation.

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

Starting and debugging

Development and runtime feel can be aided by a build workflow and a debugging inspector. Install dependencies, build the server, and then run it in a way that your MCP client can attach.

npm install
npm run build
npm run watch

For debugging, you can use the MCP Inspector tool to access debugging utilities in your browser.

npm run inspector

Notes

The server communicates over stdio, so you typically start it as a local process and connect to it from your MCP client. The token can be supplied as a command argument (--token MIRO-OAUTH-KEY) or via an environment variable, depending on your setup.

Available tools

Create Sticky

Create a new sticky note on the MIRO board with specified content and position.

Shape

Create or modify shapes on the MIRO board to organize content visually.

Read Board

Read board contents, frames, and current contents for display or processing.

Bulk Create

Create multiple items or stickies in a single operation for batch workflows.