# Miro MCP > Miro MCP Server connects your AI client directly to your visual collaboration boards. Need to organize a complex project or map out user flows? This server lets your agent manage everything: listing all boards, creating new sticky notes on specific canvases, checking member permissions, and deleting old work—all from natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** whiteboarding, visual-collaboration, brainstorming, project-planning, infinite-canvas, remote-work ## Description Connecting your agent to Miro means you don't gotta jump between two apps just to work on a board. You talk to your client, it handles the visual stuff in Miro directly. It’s like having a personal assistant who actually knows how to use the whole platform. **Managing Your Boards: The Whole Lifecycle** You can tell your agent to list every single board you have access to using `list_boards`. If you need to know what organizations are attached to your account, it'll show that too, calling out everything in `list_organizations`. You don't gotta manually click through a bunch of folders; the list comes right up. When you find a specific board ID, you can get all its details—like who owns it or what kind of template it is—by running `get_board_details`. If that project is dead and you need to clear out the clutter, it'll permanently remove a specified Miro board using `delete_board`. And if you gotta start fresh on something new, simply ask it to create an empty canvas with `create_board`. **Reading and Writing Content: What's On The Canvas?** It’s not just about the container; it’s what lives inside. You can list every single piece of content—every sticky note, shape, image, text box—on a board ID with `list_board_items`. Need to drop a quick thought onto an existing canvas? Just tell your agent to add a new sticky note with specific text using `create_sticky_note`. **Checking Collaboration and Structure** You need to know who's touching what, right? To check the collaboration status, you can run `list_board_members`. This tool gives you a roster of every user and group that has permission to view or edit that board. It keeps your work secure by showing exactly who's in the loop. You use this server to manage everything from listing all connected organizations via `list_organizations` to creating brand new, blank workspaces with `create_board`. It also lets you retrieve specific details about any existing canvas using `get_board_details`, or even wipe out old boards completely with `delete_board`. ## Tools ### create_board Creates a brand-new, blank Miro collaboration board in your account. ### create_sticky_note Adds a single text sticky note with specified content to an existing board. ### delete_board Permanently removes a specified Miro board from your workspace. ### get_board_details Retrieves specific metadata, such as the owner or template type, for one existing board. ### list_boards Returns a complete list of all Miro boards currently available in your account. ### list_board_items Lists every piece of content—notes, shapes, images—on a given board ID. ### list_board_members Retrieves a list of all users and groups who have access to the specified board. ### list_organizations Lists every linked organization or workspace that the user has access to within Miro. ## Prompt Examples **Prompt:** ``` List all boards in my Miro account. ``` **Response:** ``` I've retrieved your boards. You have access to: 'Product Roadmap Q4', 'User Interview Notes', and 'Brainstorming Session'. Which one should we open? ``` **Prompt:** ``` Add a sticky note with 'Implement SSO' to the 'Engineering' board. ``` **Response:** ``` Sticky note added! I've placed 'Implement SSO' on the 'Engineering' board (ID: uXjV...). You can check it now. ``` **Prompt:** ``` Who has access to the 'Confidential Strategy' board? ``` **Response:** ``` Inspecting members... There are 4 users with access: Alex (Owner), Sarah (Editor), David (Viewer), and the Operations Team group. ``` ## Capabilities ### Manage the entire board lifecycle The agent can create, retrieve details for, and delete whole boards within your workspace. ### Read and write content to a canvas You can list every item on a board—sticky notes, shapes, text—and add new sticky notes directly from the chat prompt. ### Check collaboration status The agent queries who is working on a board by listing all members and checking current sharing settings. ### Discover your workspace structure You can list every board available, or even list the full set of connected organizations. ## Use Cases ### The kickoff meeting needs an audit. A team lead needs to know if all stakeholders are on the 'Product Launch' board. They ask their agent: 'Who can edit the Product Launch board?' The agent runs `list_board_members` and reports back a list of 12 people with specific roles (Owner, Editor, Viewer). Problem solved before the first sketch is drawn. ### The brainstorming session needs to capture ideas. A researcher runs through a whiteboard session. When an idea pops up, they ask their agent: 'Add sticky note with 'Micro-interaction flow' to the user journey board.' The agent uses `create_sticky_note` instantly, keeping the momentum high and documenting the thought immediately. ### The project scope is unclear. A PM joins a new initiative. They ask: 'Show me all boards related to Q2 planning.' The agent uses `list_boards` and filters the results, giving them an immediate overview of relevant canvases, saving hours of manual searching. ### The team finished with old concepts. A designer wants to clean up the workspace. They tell their agent: 'Delete the V0 wireframe board.' The agent uses `delete_board` and confirms the deletion, freeing up canvas space and reducing clutter. ## Benefits - Stop manually finding boards. Use `list_boards` to get a complete directory of every Miro canvas you own or have access to, saving minutes on initial setup. - Need to audit who can edit the 'Q4 Strategy' board? Instead of clicking through permissions settings, ask your agent to use `list_board_members`. It gives you an immediate headcount and role breakdown. - Got a quick idea during a call? Use `create_sticky_note` right from your chat client. You put the thought on the canvas without ever switching screens. - Manage project scope easily. If you need to archive old work, use `delete_board`. Just give it the ID; no more searching for that dusty 'V1 Draft' board. - Cross-check ownership quickly. Use `get_board_details` when a collaborator claims they can't find the right document. It confirms who owns the board and what its current status is. ## How It Works The bottom line is that your AI client runs Miro's native API calls through natural conversation, letting you control visual assets without opening the web app. 1. Subscribe to this server on Vinkius and provide your Miro Access Token. 2. Tell your AI client what you need: 'List all boards for Product Planning.' 3. The agent calls the appropriate tools, gets the data back, and gives you a list of available boards or items. ## Frequently Asked Questions **How do I list all the boards using the Miro MCP Server?** Run `list_boards`. This tool returns a complete roster of every board you have access to in your entire account, helping you know exactly where to look. **Can I add sticky notes without opening the board first? (create_sticky_note)** Yes. You prompt the agent with `create_sticky_note` and specify which board ID and what content you want. It handles the placement directly, keeping your focus on the chat. **What if I need to check member access for a specific project? (list_board_members)** Use `list_board_members`. Give it the board ID, and it returns a detailed list of every collaborator and their exact role (Owner, Editor, Viewer). Perfect for audits. **Is there a way to see all the shapes and notes on a large canvas? (list_board_items)** Use `list_board_items`. It pulls every single content type—sticky notes, images, text boxes—off the board. This is essential for data retrieval. **How do I confirm what Miro organizations my AI agent can access using the `list_organizations` tool?** Running `list_organizations` fetches all connected accounts you have linked to the server. This lets your client scope your project and ensures you are working within the correct company boundaries before listing boards or managing members. **After I use the `create_board` tool, how do I get the unique ID for that new canvas?** The API response includes the board's unique ID immediately after creation. You must capture this specific ID to reference it later when listing items or managing members on that newly created board. **Before running the `delete_board` tool, are there any safeguards I need to worry about?** The system requires explicit confirmation before executing a delete command. Be aware that this action is irreversible and removes all associated content permanently from Miro. **When using the `get_board_details` tool, what specific metadata can my agent retrieve about a board?** The details call returns comprehensive information like ownership status, creation dates, and advanced sharing settings. This gives your AI client deeper context than just knowing the board's name. **Can I list all items on a Miro board using my AI agent?** Yes! Use the `list_board_items` tool and provide the Board ID. Your agent will retrieve all widgets, sticky notes, and text blocks on that board. **How do I add a new sticky note to a board?** Use the `create_sticky_note` action. Provide the Board ID and the content of your note to place it programmatically on the whiteboard. **Is it possible to manage board members via AI?** Yes, the `get_board_members` tool allows you to retrieve a list of all users who have access to a specific board, along with their roles.