Miro MCP server

Model Context Protocol (MCP) server integrates with the Miro platform, allowing AI assistants like Claude to access and manage Miro boards through a standardized interface. This server acts as a bridge between AI tools and your Miro workspace, enabling powerful automation and collaboration capabilities.

Requirements

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

Installation

Generate Miro Access Token

1. Go 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 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:

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

3. Update it to include this server:

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

4. Restart Claude Desktop

Available Tools

The MCP server provides access to a comprehensive set of Miro SDK functions. Here are the key capabilities:

Board Management

• List, create, update, delete, and copy boards
• Get specific board details
• Get all items on a board

Item Management

• Create, retrieve, update, and delete various item types:
  • App cards
  • Cards
  • Sticky notes
  • Frames
  • Documents
  • Text items
  • Images
  • Shapes
  • Embedded content
  • Mindmap nodes

Collaboration Features

• Create and manage tags
• Attach/detach tags to items
• Manage board members
• Share boards with others
• Create and manage groups of items

Advanced Functions

• Create items in bulk
• Export board content
• Access organization information
• Manage project members

Each tool follows a standard naming convention (e.g., "list-boards", "create-sticky-note-item"), making it intuitive to use the correct function for your specific needs.

Usage Examples

Creating a New Board

When prompting Claude, you can ask it to create a new Miro board:

Could you create a new Miro board titled "Project Brainstorm"?

Adding Items to a Board

Once you have a board, you can ask Claude to add items:

Please add a sticky note to my Project Brainstorm board with the text "Key Milestones"

Connecting Items

You can create relationships between items:

Can you create a connector between the "Key Milestones" sticky note and the "Timeline" card?

Organizing Content

Organize your board with frames and groups:

Could you create a frame titled "Research Phase" and move all the research-related sticky notes into it?

All these operations will be performed by Claude using the appropriate MCP tools provided by this server, creating a seamless experience for managing your Miro boards through conversation.

How to add this MCP server to 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 > MCP and click "Add new global MCP server".

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

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

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 explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.