mcpField
M
mcp-miro MCP Server

mcp-miro MCP Server

Local
github.com/evalstateProductivity113Updated 96w ago
Repository

About mcp-miro MCP Server

mcp-miro is an MCP server that connects to the MIRO whiteboard application for board manipulation, sticky creation and bulk operations. The README notes that photographing physical stickies and asking Claude to recreate them in MIRO works well.

Key features

  1. 01Board content manipulation
  2. 02Sticky and shape creation
  3. 03Read board, frame and contents
  4. 04Bulk create operations
  5. 05OAuth key via environment variable or --token

Use cases

  1. 01Recreating physical sticky notes as MIRO stickies
  2. 02Generating whiteboard content in bulk through Claude
  3. 03Reading MIRO board contents for analysis by Claude

MCP support

This is an MCP server that exposes MIRO board contents as resources, along with tools and prompts, to MCP clients such as Claude Desktop.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "miro": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-miro MCP Server

smithery badge

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.

mcp-miro MCP server

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

MIRO/Claude Desktop Screenshot

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.