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%\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 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.