evalstate/mcp-miro
📇 ☁️ - Access MIRO whiteboards, bulk create and read items. Requires OAUTH key for REST API.
Quick Install
{
"mcpServers": {
"evalstate-mcp-miro": {
"command": "npx",
"args": [
"-y",
"evalstate-mcp-miro"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
mcp-miro MCP Server
A Model Context Protocol server to connect to the MIRO Whiteboard Application.
- Allows Board manipulation, sticky creation, bulk operations and more.
- Pass your OAuth key as an Environment Variable, or using the "--token" argument.
- Taking a photo of stickies and asking Claude to create MIRO equivalent works really well.
Installation
Installing via Smithery
To install MIRO Whiteboard Connector for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @llmindset/mcp-miro --client claude
Using mcp-get
You can install this package using mcp-get:
npx @michaellatman/mcp-get@latest install @llmindset/mcp-miro
Note - if you are using an old version of Windows PowerShell, you may need to run Set-ExecutionPolicy Bypass -Scope Process before this command.
Features
Resources
- Get Board Contents
Tools
- Create Sticky, Shape
- Read Board, Frame, Contents
- Bulk Create
Prompts
- Instruct on Board Coordinates etc.
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-miro": {
"command": "/path/to/node-or-npx",
"arguments": [
"/path/to/mcp-miro/build/index.js",
"--token","MIRO-OAUTH-KEY"
]
}
}
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
In Dev environment recommend adding https://github.com/miroapp/api-clients/blob/041de24ebf7955432b447d887ede066ad4c7e2c7/packages/generator/spec.json for reference.