MCP Miro Server

Model Context Protocol (MCP) server integrating with the Miro platform. It enables AI assistants (like Claude) to access Miro boards and manage their content through a standardized interface.

Requirements

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

Generate Miro Access Token

1. Go to the Miro Developer Portal
2. Create a new app or use an existing one
3. Make sure to create token with permission selected below
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"
         }
      }
   }
}

1. Restart Claude Desktop

Available Tools and Resources

Tools

Local Development

1. Install dependencies:

npm install

1. Create a .env file based on the template:

cp .env.template .env

1. Edit the .env file and add your Miro access token

2. Build the server:

npm run build

Running the Server

To run the server:

node build/index.js

License

Apache License 2.0

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.