https://github.com/evalstate/mcp-miro
https://github.com/evalstate/mcp-miro
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/evalstate/mcp-miro
- Owner: evalstate
- License: apache-2.0
- Created: 2024-11-28T18:52:24.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-23T15:11:21.000Z (5 months ago)
- Last Synced: 2025-04-29T19:24:27.695Z (about 1 month ago)
- Language: TypeScript
- Size: 363 KB
- Stars: 41
- Watchers: 1
- Forks: 14
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-zh - evalstate/mcp-miro
- awesome-mcp-servers - evalstate/mcp-miro - Access MIRO whiteboards, bulk create and read items. Requires OAUTH key for REST API. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - evalstate/mcp-miro - Access MIRO whiteboards, bulk create and read items. Requires OAUTH key for REST API. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - evalstate/mcp-miro - MIROホワイトボードにアクセスし、アイテムを一括作成および読み取り。REST APIのOAUTHキーが必要。 (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
- awesome-mcp-servers - MiroMCP - Connects Claude to Miro whiteboards, enabling creation, manipulation, and bulk operations on board elements (Table of Contents / Workflow Automation)
README
# mcp-miro MCP Server
[](https://smithery.ai/server/@llmindset/mcp-miro)
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](https://smithery.ai/server/@llmindset/mcp-miro):
```bash
npx -y @smithery/cli install @llmindset/mcp-miro --client claude
```
### Using mcp-get
You can install this package using mcp-get:
```bash
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:
```bash
npm install
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
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`
```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](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
```bash
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.