Which integrations are available for this server?

Allows interaction with Miro boards, providing tools to list boards, retrieve specific board details, fetch board items like sticky notes and shapes, list frames, and search for text content across items in a board.

How do I use Miro MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Miro MCP Server Show me all the sticky notes from my project brainstorming board" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Go to MIRO Developer Portal
Create a new app or use existing one
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

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