Back

Miro MCP Server

Connect to the Miro MCP server to create boards, build layouts and diagrams, edit docs and tables, and work with comments using AI agents on Gumloop, Claude, or Cursor.

MCP server URL

https://miro.gumstack.com/mcp

Works with

Tools 48

  • Preview Resource Poll

    Check whether a Miro create-result preview resource is ready. Returns pending until the preview is available. Tags: preview, resource.

  • User Who Am I

    Returns the identity of the current authenticated user.

  • Board Search Boards

    Search and list boards accessible to the current user, scoped to their team. Returns board metadata — name and URL — suitable for navigating to a specific board or discovering relevant boards before operating on them. Use this tool when the user wants to find a board by name or description, or discover which boards are available before using other board tools. Supports offset-based pagination.

  • Board Create

    Create a new Miro board. To place the board inside a space, pass parent_space_url - either the space URL or the space content item id. Creating it in the space directly saves the extra board_move call that creating it at the team root would need. IMPORTANT: Always confirm with the user before creating a board. This action creates a new board and cannot be undone.

  • Space Create

    Create a new Miro space. A space organizes related content together (Boards; Documents; Tables; Diagrams; etc). Always give the space an icon: use the emoji the user asked for, and when they did not name one, pick a fitting emoji yourself from the space name. IMPORTANT: Always confirm with the user before creating a space. This action creates a new space and cannot be undone.

  • Section Create

    Create a new section inside a space to group related boards and content. A section must live inside a space, so provide the space URL. If no title is given, a short one is generated from the user's goal. IMPORTANT: Always confirm with the user before creating a section.

  • Section Delete

    Delete a section. Boards inside the section are not deleted; they are moved up to the parent space. IMPORTANT: Always confirm with the user before deleting a section.

  • Section Update Metadata

    Rename a section or change its position among sibling sections. Provide at least one of a new title or a new order.

  • Board Create Format

    Create a typed board format, such as a table, timeline, kanban, document, diagram, prototyping container, slide container, activities board, or embed. Use this tool when the user asks for the document/table/diagram itself as a standalone piece of content (e.g. 'create a doc in Miro about X', 'make me a table of Y'). Prefer it over adding a doc, table or diagram widget to an existing board: those tools are for adding content onto a board the user is already working on. To place the format inside a space, pass parent_space_url - either the space URL or the space content item id. Creating it in the space directly saves the extra board_move call that creating it at the team root would need. IMPORTANT: Always confirm with the user before creating content. This action cannot be undone.

  • Board Move

    Move an existing Miro board under a space or folder. Use this tool when a user asks to move a board into a space or under a folder. Provide the board and the content item id of the destination space or folder.

  • Board Move To Team

    Move a board to a different team.

  • Board Update Metadata

    Update a board's title, description and/or icon emoji. Omitted fields are left unchanged. To remove the board's icon, pass an empty string as icon_emoji.

Frequently asked questions

Related MCP servers

Further reading

What is Miro MCP?

The Miro MCP server gives AI agents access to your Miro boards. That means agents can search and list your boards, read a board’s context and items, create new boards, build layouts of sticky notes, shapes, text, cards, frames, and connectors from a simple DSL, generate diagrams, create and edit docs and tables, add images and code widgets, build interactive prototypes from HTML screens, and read and post comments. It works across the objects a working Miro board is made of, so an agent can build and read a canvas the way your team does.

Think about the last workshop or sprint planning session you ran. You copied notes onto a board by hand, rebuilt the same retro template that you did last quarter, and chased down comments scattered across a dozen frames. Instead, try using an AI agent: Describe the board you want, and your AI agent will create it for you.

MCP stands for Model Context Protocol, an open standard that connects AI agents to the tools you already use. The Miro MCP server is the bridge between your Miro account and your agent. Once you connect it on Gumloop, you can create boards, read their contents, and act on feedback just by chatting with your AI agent.

What you can do with Miro MCP on Gumloop

  • Create and find boards

    Confirm who you’re connected as, search and list the boards you can access, and create a new board (the agent confirms with you first). Your agent finds the right canvas without you clicking through Miro.

  • Read and summarize a board

    Pull a board’s text context and explore its high-level items (frames, docs, tables, diagrams, prototypes), or list items with pagination, so an agent can summarize what a canvas contains.

  • Build layouts from a simple DSL

    Read the layout DSL spec, then create or edit board items and the connectors between them with layout_create and layout_update, and read a board back as DSL. This is how an agent places sticky notes, shapes, text, cards, and frames from a plain description.

  • Generate diagrams

    Fetch the diagram DSL spec and create flowcharts, sequence flows, and other diagrams directly on the canvas.

  • Create and edit docs and tables

    Create structured docs (and read or find-and-replace their content), and create tables, read their rows, upsert rows, and switch a table’s view between grid, timeline, and kanban.

  • Add images, code widgets, and prototypes

    Upload and place images, create syntax-highlighted code widgets (with full read, update, delete, and list support), and build interactive prototypes from one or more HTML screens.

  • Read and post comments

    List the comments on a board or item, and create a new comment at a specific spot on the canvas, so an agent can leave context or flag something for the team. (The server lists and creates comments; it does not reply to or resolve threads.)

How to connect the Gumloop Miro MCP Server

  1. Create a Gumloop account

    Sign up at gumloop.com. Every new account starts with a 14-day free trial.

  2. Add the Miro MCP server

    Copy your MCP server URL from Gumloop and add it to your preferred client (Claude, Cursor, or Gumloop workflows). You'll authorize on first use.

  3. Start using Miro in your AI workflows

    That's it. Your AI agent can now build boards, read canvases, generate diagrams, and post comments on your behalf. Use it inside a Gumloop automation, in Claude Desktop, or in Cursor.

Miro MCP use cases

  • Product managers keep roadmaps current with Miro MCP

    Ask your agent to search for the roadmap board, read its items, and update a status table so the canvas matches reality before review. When a stakeholder leaves a comment, have your agent surface it and post a follow-up note on the board.

  • Designers turn ideas into canvases with Miro MCP

    Describe the flow you have in mind and let your agent lay out frames, shapes, and text from DSL to sketch the first pass. Point it at an image to drop supporting visuals onto the board, then ask it to reorganize the layout as the concept evolves.

  • Workshop facilitators run sessions with Miro MCP

    Tell your agent to create a fresh board and build a template of sticky-note columns and headers. After the session, ask it to read the board and summarize it so you leave with clear next steps instead of a wall of notes.

  • Engineering leads diagram systems with Miro MCP

    Have your agent generate a sequence flow or architecture diagram from DSL, add a code widget with the relevant snippet, and read an existing diagram back to update it as the design changes.

  • Teams turn concepts into clickable prototypes with Miro MCP

    Ask your agent to assemble a prototype from HTML screens and place it on the board, so stakeholders can click through an idea in the same canvas where the team is working.

Why use Gumloop for Miro MCP

  • Skip the OAuth setup

    You don’t register an app or manage tokens by hand. Gumloop handles the Miro OAuth flow, so connecting your account takes a couple of clicks.

  • Works with multiple MCP clients

    Use the Miro MCP server endpoint in Claude Desktop, Cursor, or directly inside Gumloop agents. Same server URL, works with any MCP client.

  • Chain Miro with 100+ other integrations

    Chain Miro with any other MCP integrations in a single agent, so a board summary can flow into your docs, chat, and project tools automatically.

  • Enterprise-grade and trustworthy

    The Miro MCP server respects your existing board permissions and access controls. For details on Gumloop’s security practices, see trust.gumloop.com.

  • Start with a free trial

    You can test the Miro MCP integration during Gumloop’s 14-day free trial before committing. Paid plans start at $37/month.