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

Permission	Required
boards:read
boards:write
identity:read
identity:write
team:read
team:write
microphone:listen
screen:record
webcam:record
auditlogs:read
sessions:delete

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%Claudeclaude_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 and Resources

Tools

Miro SDK Function	MCP Tool	Available
List boards	list-boards
Create board	create-board
Update board	update-board
Delete board	delete-board
Copy board	copy-board
Get specific board	get-specific-board
Get items on board	get-items-on-board
Get specific item	get-specific-item
Update item position	update-item-position
Delete item	delete-item
Create app card item	create-app-card-item
Get app card item	get-app-card-item
Update app card item	update-app-card-item
Delete app card item	delete-app-card-item
Create card item	create-card-item
Get card item	get-card-item
Update card item	update-card-item
Delete card item	delete-card-item
Create connector	create-connector
Get connectors	get-connectors
Get specific connector	get-specific-connector
Update connector	update-connector
Delete connector	delete-connector
Create sticky note item	create-sticky-note-item
Get sticky note item	get-sticky-note-item
Update sticky note item	update-sticky-note-item
Delete sticky note item	delete-sticky-note-item
Create frame	create-frame
Get frame item	get-frame-item
Update frame item	update-frame-item
Delete frame item	delete-frame-item
Create document item	create-document-item
Get document item	get-document-item
Update document item	update-document-item
Delete document item	delete-document-item
Create text item	create-text-item
Get text item	get-text-item
Update text item	update-text-item
Delete text item	delete-text-item
Create items in bulk	create-items-in-bulk
Create image item using URL	create-image-item-using-url
Create image item using file	create-image-item-using-file
Get image item	get-image-item
Update image item	update-image-item
Update image item using file	update-image-item-using-file
Delete image item	delete-image-item
Create shape item	create-shape-item
Get shape item	get-shape-item
Update shape item	update-shape-item
Delete shape item	delete-shape-item
Create embed item	create-embed-item
Get embed item	get-embed-item
Update embed item	update-embed-item
Delete embed item	delete-embed-item
Create tag	create-tag
Get tag	get-tag
Get all tags	get-all-tags
Update tag	update-tag
Delete tag	delete-tag
Attach tag	attach-tag
Detach tag	detach-tag
Get item tags	get-item-tags
Get all board members	get-all-board-members
Get specific board member	get-specific-board-member
Remove board member	remove-board-member
Share board	share-board
Update board member	update-board-member
Create group	create-group
Get all groups	get-all-groups
Get group	get-group
Get group items	get-group-items
Update group	update-group
Ungroup items	ungroup-items
Delete group	delete-group
Create items in bulk using file	create-items-in-bulk-using-file
Create mindmap node	create-mindmap-node
Get mindmap node	get-mindmap-node
Get mindmap nodes	get-mindmap-nodes
Delete mindmap node	delete-mindmap-node
Add project member	add-project-member
Create board export job	create-board-export-job
Get all cases	get-all-cases
Get all legal holds	get-all-legal-holds
Get audit logs	get-audit-logs
Get board classification	get-board-classification
Get board content logs	get-board-content-logs
Get board export job results	get-board-export-job-results
Get board export job status	get-board-export-job-status
Get case	get-case
Get legal hold	get-legal-hold
Get legal hold content items	get-legal-hold-content-items
Get organization info	get-organization-info
Get organization member	get-organization-member
Get organization members	get-organization-members
Get project member	get-project-member
Remove project member	remove-project-member
Update board classification	update-board-classification

Local Development

1. Install dependencies:

npm install

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

cp .env.template .env

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

4. 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.