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:readboards: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 boardsget_board- Get details about a specific boardget_board_items- Get all items from a boardget_board_frames- Get all frames from a boardsearch_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.jsfile - No Boards Found: Verify your token has access to at least one board
License
MIT