# Miro MCP

> Miro Visual Collaboration & Whiteboarding MCP lets your AI agent manage complex digital whiteboards and team ideation. List all accessible boards, inject sticky notes or custom shapes, and audit every element on a canvas. Quickly check who has access to a board or pull the organizational tags applied across a project.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Tags:** whiteboarding, visual-collaboration, ideation, agile-workflows, digital-sticky-notes, team-planning

## Description

Take full control of visual collaboration and idea mapping through your AI client. This MCP connects directly to your Miro account, letting you treat digital whiteboards like any other data source. Instead of manually opening boards and clicking around, you can simply ask your agent to handle the heavy lifting. Need to track project milestones? You can list all accessible collaborative boards or create a fresh one for a new initiative. Want to annotate a specific idea? Your agent can attach sticky notes or geometric shapes right onto the canvas using coordinates. Beyond adding visuals, you can audit the entire board state by listing every item inside it. It also checks who is sharing access and pulls semantic organizational tags used across your project metadata. By connecting this MCP via Vinkius, you bring structured control to unstructured visual data.

## Tools

### list_boards
Retrieves a list of all Miro Boards accessible across your account globally.

### get_board
Pulls the static, explicit configuration details for one specific Miro Board ID.

### create_board
Initializes a brand new collaborative Miro Board with custom titles and descriptions.

### list_items
Lists all raw visual items physically attached inside a specific Miro Board ID.

### create_sticky_note
Creates and attaches a new sticky note component to any designated Miro Board area.

### create_shape
Generates and attaches a specified geometric shape structure onto a board.

### list_members
Lists all active team members who share access bounds across a specific Miro Board.

### list_tags
Retrieves the semantic organizational tags applied inside a board to manage project metadata.

## Prompt Examples

**Prompt:** 
```
List all my Miro boards
```

**Response:** 
```
I've retrieved 3 boards from your Miro account: 'Product Roadmap Q1' (ID: 12345), 'UX Research: User Flow' (ID: 67890), and 'Sprint Retrospective' (ID: 13579). Which one would you like to inspect or add items to?
```

**Prompt:** 
```
Create a sticky note on board '12345' with the text 'Review API auth flow'
```

**Response:** 
```
Sticky note created! I've successfully added 'Review API auth flow' to your 'Product Roadmap Q1' board. The item has been injected onto the canvas and is now visible to all collaborators.
```

**Prompt:** 
```
Show me the tags used in the 'UX Research' board
```

**Response:** 
```
Retrieving tags… I've identified 4 semantic tags in the 'UX Research' board: 'High Priority', 'User Pain Point', 'Feature Request', and 'Follow-up Needed'. Would you like me to list the items associated with any of these tags?
```

## Capabilities

### Manage Board Structure
List all existing Miro boards or create entirely new collaborative canvases.

### Add Visual Elements
Inject specific sticky notes, rectangles, circles, or triangles onto designated areas of any board.

### Inspect Board Contents
List every distinct visual item—text blocks and shapes—attached inside a board for a full audit.

### Audit Team Access
Check which team members have active viewer or editor permissions on a given board.

### Manage Metadata Tags
Retrieve the specific semantic organizational tags applied to a board, helping you manage project metadata efficiently.

## Use Cases

### Synthesizing Post-Meeting Brainstorms
A PM asks their agent to list all collaborative boards related to 'Q3 launch' and then checks who has editing access on each. The agent returns a summary of the board titles, their current members, and suggests which boards need immediate follow-up.

### Annotating Research Findings
A UX designer reads user feedback and prompts the agent to create sticky notes with key findings on the 'User Flow' board. The agent injects these specific notes onto the correct coordinates, keeping the research visible to the team.

### Quick Project Kickoff
A manager needs a new space for a client pitch. They prompt the agent to create a brand new collaborative canvas with 'Client X Pitch Deck' as the title. The board is provisioned instantly, ready for input.

### Auditing Complex Diagrams
An engineer needs proof of what was discussed on an old architecture diagram. They ask the agent to list all items inside that specific board ID, confirming every text block and shape attached before a meeting.

## Benefits

- Stop clicking through boards. You can list all accessible Miro boards and get a complete overview of your project landscape instantly, without manual navigation.
- Quickly log insights by having your agent inject sticky notes or custom shapes directly onto the canvas using just text prompts; no need to open the board first.
- Maintain alignment by auditing collaborative board memberships. The MCP lists all active team members and confirms their specific viewer or editor permissions.
- Understand the project state fully. You can list every distinct visual item attached inside a board, providing an instant audit of everything present.
- Keep your data organized using `list_tags`. This tool pulls raw index groupings and semantic tags applied across the entire board for efficient metadata management.

## How It Works

The bottom line is you get natural language control over complex visual workspaces without ever leaving your chat window.

1. Subscribe to this MCP and provide your Miro Access Token.
2. Run a command through any MCP-compatible client to specify the action (e.g., list boards, create notes, or audit members).
3. Your agent executes the request against Miro and returns structured data about the board's current state or confirms the successful creation of an element.

## Frequently Asked Questions

**How do I use Miro Visual Collaboration & Whiteboarding MCP to see all my boards?**
Run `list_boards` through your agent. It retrieves a high-level list of every board you have access to, giving you an immediate map of your project work.

**Can I add notes using the Miro Visual Collaboration & Whiteboarding MCP?**
Yes, use `create_sticky_note`. You can ask your agent to attach a new sticky note with specific text directly onto any board you specify.

**What if I need to audit team permissions on Miro? Use the Miro Visual Collaboration & Whiteboarding MCP.**
You run `list_members` on the target Board ID. The agent gives a definitive list of all active users and specifies whether they are viewing or editing the content.

**Is there a way to create new Miro boards using the MCP?**
Absolutely. Use `create_board` to initialize fresh collaborative canvases instantly, allowing you to start a new project board without manual setup.

**Does this MCP help with organizing metadata tags on Miro? Use the Miro Visual Collaboration & Whiteboarding MCP.**
Yes. Running `list_tags` pulls all semantic organizational tags applied inside a board, helping you track project groupings and metadata efficiently.