MIRO

Provides MIRO board data via MCP for Claude Desktop, including boards, items, frames, and content search.

javascript

0

GitHub Stars

javascript

Language

5 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": {
    "jlromano-miro-mcp": {
      "command": "node",
      "args": [
        "/Users/your_user/Claude-Projects/MIRO-mcp/dist/index.js"
      ],
      "env": {
        "MIRO_ACCESS_TOKEN": "your_miro_access_token_here"
      }
    }
  }
}

You can use this MCP server to let Claude Desktop interact with MIRO boards. It lets you list boards, fetch board details and items, inspect frames, and search content across a board, enabling streamlined workflows and automation.

How to use

After you configure the MCP server, you can perform common actions from Claude Desktop using the MIRO MCP commands. Use these patterns to explore your MIRO spaces and retrieve data such as boards, items, frames, and text content.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

# 1) Install dependencies
npm install

# 2) Create a local environment file
cp .env.example .env

Configure your environment with your MIRO access token.

# Edit the .env file to include your token
MIRO_ACCESS_TOKEN=your_actual_token_here

Build the MCP server.

npm run build

Configure Claude Desktop to load the MIRO MCP server. Use the following configuration as a starting point, replacing the path with your actual built index file.

{
  "mcpServers": {
    "miro": {
      "command": "node",
      "args": ["/Users/your_user/Claude-Projects/MIRO-mcp/dist/index.js"],
      "env": {
        "MIRO_ACCESS_TOKEN": "your_miro_access_token_here"
      }
    }
  }
}

Restart Claude Desktop to load the MIRO MCP server.

Additional sections

Configuration and security considerations: ensure your MIRO access token has the required scopes (boards:read, boards:write if you need future write capabilities). Keep tokens secret and avoid committing them to version control.

Troubleshooting notes: if authentication fails, verify the token is valid and has the needed permissions. If Claude Desktop cannot load the MCP server, confirm the path to dist/index.js is correct and that the server process is running.

Notes: the server exposes endpoints to list boards, get board details, retrieve board items, fetch frames, and search content across a board.

Tools and endpoints you can use from Claude

list_boards: List all MIRO boards you have access to.
get_board: Retrieve details for a specific board.
get_board_items: Get all items/widgets on a board.
get_board_frames: List all frames within a board.
search_board_content: Search text across all items in a board.

Available tools

list_boards

List all MIRO boards you have access to.

get_board

Retrieve details for a specific board.

get_board_items

Fetch all items/widgets from a board, such as sticky notes, text, shapes, and cards.

get_board_frames

List all frames in a board.

search_board_content

Search for text content across all items in a board.