# 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](https://miro.com/app/settings/user-profile/apps)
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
```bash
npm install
```
### 3. Configure Environment
Create a `.env` file:
```bash
cp .env.example .env
```
Edit `.env` and add your MIRO access token:
```
MIRO_ACCESS_TOKEN=your_actual_token_here
```
### 4. Build the Server
```bash
npm run build
```
### 5. Configure Claude Desktop
Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"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:
```bash
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
