
Miro
Connect to Miro boards through WayStation to read, create, and modify visual content like sticky notes, shapes, and diagrams programmatically.
Integrates with Miro's collaborative whiteboard platform, providing over 80 tools for managing boards, creating and manipulating various item types, and handling enterprise features for visual collaboration workflows.
What it does
- Create and edit sticky notes on Miro boards
- Add shapes and diagrams to boards
- Read existing board content and structure
- Move and organize board elements
- Access board metadata and properties
Best for
About Miro
Miro is a community-built MCP server published by k-jarzyna that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrate with Miro's online whiteboard for seamless collaboration. Manage boards, create items, and use 80+ tools for v It is categorized under productivity.
How to install
You can install Miro in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
Miro is released under the Apache-2.0 license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
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:
{
"mcpServers":{
"miro":{
"command":"npx",
"args":[
"-y",
"@k-jarzyna/mcp-miro"
],
"env":{
"MIRO_ACCESS_TOKEN":"your_miro_access_token"
}
}
}
}
- 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:
npm install
- Create a
.envfile based on the template:
cp .env.template .env
-
Edit the
.envfile and add your Miro access token -
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.
Alternatives
Related Skills
Browse all skillsPERSONAL APP ARCHITECT - Strategic development orchestrator for personal productivity applications. Analyzes project context, makes architectural decisions for single-developer projects, delegates to specialized skills, and ensures alignment between user experience goals and technical implementation. Optimized for personal apps targeting 10-100 users.
Analyze conversation patterns, track productivity, and surface self-knowledge insights. Use when user wants to understand their own patterns (when they chat, what topics they discuss, productivity trends, sentiment over time). Provides weekly/monthly reports, topic recommendations, and time-based insights. Privacy-first design with all analysis local.
Install and configure essential Windsurf extensions for productivity. Activate when users mention "install extensions", "setup windsurf plugins", "configure extensions", "extension recommendations", or "productivity extensions". Handles extension installation and configuration. Use when working with windsurf extension pack functionality. Trigger with phrases like "windsurf extension pack", "windsurf pack", "windsurf".
Expert methodology for defining, tracking, and interpreting engineering performance metrics including DORA, team health, productivity, and executive reporting.
Expert email management assistant for Apple Mail. Use this when the user mentions inbox management, email organization, email triage, inbox zero, organizing emails, managing mail folders, email productivity, checking emails, or email workflow optimization. Provides intelligent workflows and best practices for efficient email handling.
Analyze team AI usage patterns and productivity metrics. Activate when users mention "usage analytics", "ai metrics", "productivity tracking", "usage reports", or "roi analysis". Handles analytics and reporting configuration. Use when working with windsurf usage analytics functionality. Trigger with phrases like "windsurf usage analytics", "windsurf analytics", "windsurf".