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
Notion
Server for interacting with Notion
- Productivity & Collaboration
- OAuth
Confluence
Server for interacting with Confluence Cloud
- Developer Tools
- OAuth
Asana
Interact with Asana projects, tasks, and workspace management
- Productivity & Collaboration
- OAuth
Trello
Interact with Trello to manage boards, lists, cards, checklists, labels, custom fields, and comments
- Productivity & Collaboration
- OAuth
JIRA
Interact with JIRA for project management, issue tracking, and user information access.
- Developer Tools
- OAuth
Slack
Interact with Slack channels and messages
- Productivity & Collaboration
- OAuth
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
Create a Gumloop account
Sign up at gumloop.com. Every new account starts with a 14-day free trial.
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.
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.