Miro MCP server

The MCP Miro Server is a Model Context Protocol server that integrates with the Miro platform, enabling AI assistants like Claude to access, view, and manage Miro boards through a standardized interface. This allows AI assistants to interact with visual collaboration content in real-time.

Installation Requirements

• Node.js v16 or newer
• Miro account with API token

Setup Guide

Generating a Miro Access Token

1. Navigate to the Miro Developer Portal
2. Create a new app or use an existing one
3. Ensure your token has the following required permissions:
   • boards:read
   • boards:write
   • identity:read
   • identity:write
   • team:read
   • team:write
4. Generate the OAuth token by selecting "Install app and get OAuth token"

Connecting with Claude Desktop

1. Install Claude Desktop

2. Open or create the configuration file at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Update the configuration file to include the MCP Miro server:

{
   "mcpServers":{
      "miro":{
         "command":"npx",
         "args":[
            "-y",
            "@k-jarzyna/mcp-miro"
         ],
         "env":{
            "MIRO_ACCESS_TOKEN":"your_miro_access_token"
         }
      }
   }
}

4. Restart Claude Desktop to apply the changes

Available Functionality

The MCP Miro Server provides a comprehensive set of tools for interacting with Miro boards:

Board Management

• List, create, update, and delete boards
• Copy boards
• Get specific board information
• Manage board members and sharing

Item Management

• Create, retrieve, update, and delete various item types:
  • App cards
  • Cards
  • Sticky notes
  • Frames
  • Documents
  • Text items
  • Images
  • Shapes
  • Embed items
  • Mindmap nodes
• Create items in bulk
• Get items on a board
• Update item positions

Organization and Collaboration

• Create and manage tags
• Attach and detach tags from items
• Create and manage groups
• Export board content
• Get organization information and members
• Manage project members

All these capabilities are exposed through standardized MCP tools that Claude can use when you've configured the server properly.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "miro" '{"command":"npx","args":["-y","@k-jarzyna/mcp-miro"],"env":{"MIRO_ACCESS_TOKEN":"your_miro_access_token"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "miro": {
            "command": "npx",
            "args": [
                "-y",
                "@k-jarzyna/mcp-miro"
            ],
            "env": {
                "MIRO_ACCESS_TOKEN": "your_miro_access_token"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "miro": {
            "command": "npx",
            "args": [
                "-y",
                "@k-jarzyna/mcp-miro"
            ],
            "env": {
                "MIRO_ACCESS_TOKEN": "your_miro_access_token"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect