# Miro MCP > Miro lets your AI client control complex visual collaboration boards through natural conversation. Create entirely new whiteboards, add sticky notes with specific content, track team feedback via comments, or review every widget on existing canvases without opening the Miro app. Manage board members and audit project structures instantly. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Tags:** whiteboarding, visual-collaboration, diagramming, team-workflow, sticky-notes, real-time-sync ## Description You can take full control of your visual workspace by connecting your account to any AI agent. Instead of clicking through menus in a separate application, you simply talk to your client about what needs fixing or adding to a board. You can tell it to generate an entire new whiteboard for a project kick-off, and it'll handle the setup. Need meeting notes? Ask your agent to drop a sticky note with specific text at coordinates (x:100, y:200). It handles that automatically. Your client can list all current board members or check if a certain widget exists on a canvas. When you see tools like this hosted in the Vinkius catalog, it means your AI agent is ready to treat complex visual boards like structured data. You get instant visibility into everything—from reviewing historical comments to listing every single card and shape currently placed on the board. ## Tools ### add_board_member Adds a specific user to the whiteboard and lets you set their access role (owner, admin, editor, commenter, viewer). ### create_board Generates an entirely new Miro board with a given name and optional description. ### create_card Creates a structured card widget on the board, allowing you to set a title and description. ### create_comment Posts new feedback or comments directly onto the whiteboard, optionally replying to an existing comment. ### create_sticky_note Places a simple sticky note with custom text content on the board at specific coordinates. ### delete_board_item Removes any widget from the board using both the board ID and the item's unique ID. (Warning: this action is permanent.) ### get_board Retrieves all metadata for a specific Miro board, including its owner and permissions. ### get_board_item Fetches the detailed information for one single widget on a whiteboard using its ID. ### get_user_context Confirms your identity and access details, showing what Miro user the API calls will be made as. ### list_board_items Lists every widget on a board, allowing you to filter by type (sticky note, card, shape, etc.) and view its content and position. ### list_board_members Retrieves a list of all users who have access to the whiteboard, along with their roles and emails. ### list_boards Provides an overview of all Miro boards that your user account can currently see or access. ### list_comments Retrieves a list of comments on the board, including who wrote them and when they were posted. ### update_board Changes the name or description metadata of an existing Miro whiteboard. ## Prompt Examples **Prompt:** ``` Show me all the sticky notes on my Sprint Planning board. ``` **Response:** ``` I found 12 sticky notes on your Sprint Planning board. Topics include: 'Implement OAuth flow', 'Fix checkout bug', 'Design new dashboard', 'Update API docs', 'Refactor auth middleware' and 7 more. Would you like the full content of any specific note? ``` **Prompt:** ``` Create a new board called 'Q2 OKRs' with a description 'Quarterly objectives and key results'. ``` **Response:** ``` Done! I've created the board 'Q2 OKRs' with the description. The board is ready for collaboration. Board URL: https://miro.com/app/board/uXjV... You can now add sticky notes, cards and other items to it. ``` **Prompt:** ``` Add a sticky note to my board saying 'Meeting notes: Discussed API versioning strategy' at position x:100, y:200. ``` **Response:** ``` Done! I've added the sticky note at position (100, 200) on your board with the text 'Meeting notes: Discussed API versioning strategy'. All board collaborators can see it immediately. ``` ## Capabilities ### Generate new whiteboards Create an entirely new Miro board with a specified title or description. ### Add content widgets Place specific items, like sticky notes or structured cards, onto any existing whiteboard at defined locations. ### Audit board contents List every widget on a board—sticky notes, images, shapes, etc.—including their content and coordinates for review. ### Manage team access See who is already on the board and add new users with specific roles like owner or editor. ### Track conversations Read existing comments or post new feedback directly to a whiteboard for asynchronous discussion. ## Use Cases ### Need to compile feedback from multiple stakeholders. A project lead asks their agent to list all comments on the 'V2 Launch' board. The agent returns a summary of recent discussions, allowing the lead to instantly see where key decisions were made without reading through hundreds of individual messages. ### Launching a new initiative requires a dedicated workspace. A Product Manager simply asks their client to create_board with the name 'Q4 Strategy' and description 'Focus on market penetration.' The board is generated immediately, ready for team input. ### Need to update core documentation widgets. A designer uses list_board_items to find all cards labeled 'API Spec' across the board. They then use create_card and provide updated text, ensuring all documentation widgets are current in one conversational step. ### Onboarding a new team member who needs limited access. A Team Lead uses list_board_members to verify the board permissions. They then call add_board_member, granting the new hire only 'commenter' status so they can participate without accidentally moving critical elements. ## Benefits - Stop context switching. Instead of opening the Miro app to add a quick sticky note, just ask your agent to create one for you instantly. - Audit board contents completely. You can use list_board_items to view every widget on a canvas—cards, shapes, notes—and understand what's actually there without manual clicking. - Maintain team hygiene effortlessly. Use list_board_members to check who needs access and then call add_board_member to grant or adjust roles like 'editor' or 'viewer.' - Keep project history organized. List comments retrieves all feedback, letting you review the discussion thread without scrolling through a messy UI. - Build new structures fast. If you need a starting point, use create_board to generate an entirely new board with specific naming and descriptions. ## How It Works The bottom line is you get direct, conversational control over your complex whiteboarding content without leaving your AI chat window. 1. Subscribe to this MCP and provide your Miro Access Token (OAuth 2.0 or Personal Access Token). 2. Your AI client authenticates the connection, granting permission to manage your visual workspaces. 3. You prompt your agent with a natural language request—for instance, 'Add three sticky notes about Q3 goals'—and it executes the action directly in Miro. ## Frequently Asked Questions **How do I use Miro MCP to list all boards?** Use the list_boards tool to see an overview of every board accessible by your account. This lets you find the correct ID before running any other action, like get_board. **Can Miro MCP help me add members with specific roles?** Yes, use the add_board_member tool. You provide the board ID and the user ID, and you can specify exactly what role they need: owner, admin, editor, commenter, or viewer. **What is the difference between list_board_items and get_board_item with Miro MCP?** list_board_items returns a comprehensive inventory of every widget on the board. get_board_item only retrieves specific, detailed information for one single item you already know the ID of. **How do I make sure my sticky notes are in the right spot using Miro MCP?** When creating a note with create_sticky_note, you can optionally provide x and y coordinates. This ensures your agent places the content exactly where you want it on the canvas. **Does Miro MCP allow me to read old comments?** You can use list_comments to retrieve a history of conversations. The tool provides the comment text, author info, and date so you can track feedback over time.