The Miro MCP Server enables AI assistants to interact with and manage Miro boards through a standardized interface.
Core Capabilities:
- Board Management: List, create, update, delete, copy, and retrieve Miro boards
- Item Management: Add, update, delete and retrieve various items (sticky notes, shapes, text, images, documents, frames, app cards)
- Connector Management: Create and manage connections between items
- Bulk Operations: Create or update multiple items simultaneously using JSON files or schemas
- Tag Management: Create, update, attach, detach, and retrieve tags
- Group Management: Create, update, retrieve groups and manage grouped items
- Mind Map Management: Create, retrieve, and delete mind map nodes
- Access Control: Share boards, manage board members, and update roles
Enterprise-Only Features:
- Export boards and retrieve export status
- Manage legal holds and eDiscovery cases
- Retrieve audit logs and content change history
- Perform organizational tasks like managing project members
Provides tools for accessing and managing Miro boards including creating, updating, and deleting boards and various board items (sticky notes, cards, frames, images, text, shapes, connectors, tags). Supports advanced features like grouping items, sharing boards, managing board members, and exporting board content.
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
- Go to the Miro Developer Portal
- Create a new app or use an existing one
- Make sure to create token with permission selected below
- 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
- Install Claude Desktop
- Open or create the configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Update it to include this server:
- 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
- Install dependencies:
- Create a
.env
file based on the template:
- Edit the
.env
file and add your Miro access token - Build the server:
Running the Server
To run the server:
License
Apache License 2.0
This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Miro MCP server, exposing all functionalities available in official Miro SDK.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server to connect to the MIRO Whiteboard Application. Allows Board manipulation, sticky creation, bulk operations and more.Last updated -63120TypeScriptApache 2.0
- -securityFlicense-qualityAn MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.Last updated -116JavaScript
- -securityAlicense-qualityA server for the Machine Chat Protocol (MCP) that provides a YAML-based configuration system for LLM applications, allowing users to define resources, tools, and prompts without writing code.Last updated -5PythonMIT License
- AsecurityFlicenseAqualityAn MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.Last updated -3928