MIRO MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with MIRO boards.

Features

• List Boards: Get all accessible MIRO boards
• Get Board Details: Retrieve specific board information
• Get Board Items: Fetch all items/widgets from a board (sticky notes, text, shapes, cards, etc.)
• Get Frames: List all frames in a board
• Search Content: Search for text across all items in a board

Setup

1. Get MIRO API Token

1. Go to MIRO Developer Portal
2. Create a new app or use existing one
3. Generate an access token with these scopes:
   • boards:read
   • boards:write (optional, for future enhancements)

2. Install Dependencies

npm install

3. Configure Environment

Create a .env file:

cp .env.example .env

Edit .env and add your MIRO access token:

MIRO_ACCESS_TOKEN=your_actual_token_here

4. Build the Server

npm run build

5. Configure Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Note: Replace the path in args with the actual path to your built index.js file.

6. Restart Claude Desktop

After configuration, restart Claude Desktop to load the MCP server.

Development

Run in development mode with auto-reload:

npm run dev

Available Tools in Claude

Once configured, you can use these commands in Claude Desktop:

• list_boards - List your MIRO boards
• get_board - Get details about a specific board
• get_board_items - Get all items from a board
• get_board_frames - Get all frames from a board
• search_board_content - Search for text in board items

Example Usage in Claude:

"Can you show me all my MIRO boards?"

"Get all sticky notes from board [board_id]"

"Search for 'project timeline' in board [board_id]"

Troubleshooting

1. Authentication Error: Ensure your MIRO access token is valid and has the correct permissions
2. Server Not Found: Check that the path in Claude Desktop config points to the correct dist/index.js file
3. No Boards Found: Verify your token has access to at least one board

License

MIT