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.

62321 views19Local (stdio)

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

Automating meeting notes and retrospectivesSyncing project data with visual boardsProduct managers organizing feature roadmapsTeams doing collaborative planning sessions
No-code integration through WayStationDirect board manipulation capabilities

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

Trust Score smithery badge

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
PermissionRequired
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"
         }
      }
   }
}
  1. Restart Claude Desktop

Available Tools and Resources

Tools

Miro SDK FunctionMCP ToolAvailable
List boardslist-boards
Create boardcreate-board
Update boardupdate-board
Delete boarddelete-board
Copy boardcopy-board
Get specific boardget-specific-board
Get items on boardget-items-on-board
Get specific itemget-specific-item
Update item positionupdate-item-position
Delete itemdelete-item
Create app card itemcreate-app-card-item
Get app card itemget-app-card-item
Update app card itemupdate-app-card-item
Delete app card itemdelete-app-card-item
Create card itemcreate-card-item
Get card itemget-card-item
Update card itemupdate-card-item
Delete card itemdelete-card-item
Create connectorcreate-connector
Get connectorsget-connectors
Get specific connectorget-specific-connector
Update connectorupdate-connector
Delete connectordelete-connector
Create sticky note itemcreate-sticky-note-item
Get sticky note itemget-sticky-note-item
Update sticky note itemupdate-sticky-note-item
Delete sticky note itemdelete-sticky-note-item
Create framecreate-frame
Get frame itemget-frame-item
Update frame itemupdate-frame-item
Delete frame itemdelete-frame-item
Create document itemcreate-document-item
Get document itemget-document-item
Update document itemupdate-document-item
Delete document itemdelete-document-item
Create text itemcreate-text-item
Get text itemget-text-item
Update text itemupdate-text-item
Delete text itemdelete-text-item
Create items in bulkcreate-items-in-bulk
Create image item using URLcreate-image-item-using-url
Create image item using filecreate-image-item-using-file
Get image itemget-image-item
Update image itemupdate-image-item
Update image item using fileupdate-image-item-using-file
Delete image itemdelete-image-item
Create shape itemcreate-shape-item
Get shape itemget-shape-item
Update shape itemupdate-shape-item
Delete shape itemdelete-shape-item
Create embed itemcreate-embed-item
Get embed itemget-embed-item
Update embed itemupdate-embed-item
Delete embed itemdelete-embed-item
Create tagcreate-tag
Get tagget-tag
Get all tagsget-all-tags
Update tagupdate-tag
Delete tagdelete-tag
Attach tagattach-tag
Detach tagdetach-tag
Get item tagsget-item-tags
Get all board membersget-all-board-members
Get specific board memberget-specific-board-member
Remove board memberremove-board-member
Share boardshare-board
Update board memberupdate-board-member
Create groupcreate-group
Get all groupsget-all-groups
Get groupget-group
Get group itemsget-group-items
Update groupupdate-group
Ungroup itemsungroup-items
Delete groupdelete-group
Create items in bulk using filecreate-items-in-bulk-using-file
Create mindmap nodecreate-mindmap-node
Get mindmap nodeget-mindmap-node
Get mindmap nodesget-mindmap-nodes
Delete mindmap nodedelete-mindmap-node
Add project memberadd-project-member
Create board export jobcreate-board-export-job
Get all casesget-all-cases
Get all legal holdsget-all-legal-holds
Get audit logsget-audit-logs
Get board classificationget-board-classification
Get board content logsget-board-content-logs
Get board export job resultsget-board-export-job-results
Get board export job statusget-board-export-job-status
Get caseget-case
Get legal holdget-legal-hold
Get legal hold content itemsget-legal-hold-content-items
Get organization infoget-organization-info
Get organization memberget-organization-member
Get organization membersget-organization-members
Get project memberget-project-member
Remove project memberremove-project-member
Update board classificationupdate-board-classification

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.

Alternatives

Related Skills

Browse all skills
chief-architect

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

0
personal-analytics

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.

0
windsurf-extension-pack

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

0
cto-engineering-metrics

Expert methodology for defining, tracking, and interpreting engineering performance metrics including DORA, team health, productivity, and executive reporting.

0
email-management-expert

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.

0
windsurf-usage-analytics

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

0