olgasafonova avatar

Miro

olgasafonova/miro-mcp-server

A Go-based bridge to the Miro REST API that exposes 92 tools for controlling boards programmatically. You get full CRUD for sticky notes, shapes, frames, connectors, mindmaps, and tags, plus Mermaid diagram generation and PDF export on Enterprise plans. Ships as a single binary with stdio transport, runs on all platforms, and works with Claude Desktop, Cursor, and any MCP client. The essentials profile (15 tools plus on-demand discovery) cuts context overhead from 15.5K to 2.4K tokens when you need to stay lean. Same author maintains a companion CLI for shell scripting and a TypeScript MCP Apps server for rendering board data as interactive UI cards instead of JSON.

GitHub stars
31
tools
15
transport
STDIO
env var
1
last updated
Sep 18, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

MIRO_CREATE_APP_CARD_ITEMTool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board (e.g., after assembling card data).6 params

Tool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board (e.g., after assembling card data).

Parameters* required
board_idstring
ID of the board to add the app card to
dataobject
Payload data for the app card
geometryobject
Geometrical dimensions for an app card item.
parentobject
Parent frame reference for nesting an app card item.
positionobject
Board position for an app card item.
styleobject
Styling options for an app card item.
MIRO_CREATE_BOARDTool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan".5 params

Tool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan".

Parameters* required
descriptionstring
Description of the board, length between 0 and 300 characters.
namestring
Name for the board, length between 1 and 60 characters.
policyobject
Defines permissions and sharing policies for the board.
projectIdstring
Unique identifier (ID) of the project (space) to which the board belongs.
teamIdstring
Unique identifier (ID) of the team where the board will be created.
MIRO_DELETE_APP_CARD_ITEMTool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed.2 params

Tool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed.

Parameters* required
board_idstring
Unique identifier of the board containing the app card item.
item_idstring
Unique identifier of the app card item to delete.
MIRO_DELETE_DOCUMENT_ITEMTool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from board 'board123'."2 params

Tool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from board 'board123'."

Parameters* required
board_idstring
Unique identifier of the board containing the document item.
item_idstring
Unique identifier of the document item to delete.
MIRO_DELETE_ITEMTool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs.2 params

Tool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs.

Parameters* required
board_idstring
Unique identifier of the board containing the item.
item_idstring
Unique identifier of the item to delete.
MIRO_GET_APP_CARD_ITEMTool to retrieve a specific app card item by its ID. Use when you need the details of an existing app card item.2 params

Tool to retrieve a specific app card item by its ID. Use when you need the details of an existing app card item.

Parameters* required
board_idstring
Unique identifier of the board containing the app card item
item_idstring
Unique identifier of the app card item to retrieve
MIRO_GET_BOARDTool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata.1 params

Tool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata.

Parameters* required
board_idstring
Unique identifier of the board to retrieve
MIRO_GET_BOARD_ITEMSTool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting.4 params

Tool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting.

Parameters* required
board_idstring
Unique identifier of the board to retrieve items from
cursorstring
Cursor for paginating results; use the value from a prior response.
limitinteger
Maximum number of items to return per page (min 1)
typestring
Filter by item type. Examples: 'shape', 'sticky_note', 'card', 'frame', 'text', 'image'
MIRO_GET_BOARD_MEMBERSTool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID.3 params

Tool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID.

Parameters* required
board_idstring
Unique identifier of the board.
cursorstring
Cursor for pagination, used to retrieve subsequent pages.
limitinteger
Number of results per page (max 100).
MIRO_GET_BOARDSTool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords.7 params

Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords.

Parameters* required
limitinteger
Number of boards to return per page.
offsetinteger
Offset for pagination.
ownerstring
Filter boards by owner user ID.
project_idstring
Filter boards by project (space) ID.
querystring
Search query to filter boards by name.
sortstring
Sort order of the results.one of default · last_created · last_opened · last_modified · alphabetically
team_idstring
Filter boards by team ID.
MIRO_GET_CONNECTORSTool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.3 params

Tool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.

Parameters* required
board_idstring
Unique identifier of the board to retrieve connectors from.
cursorstring
Cursor for pagination to retrieve the next page of connectors.
limitinteger
Maximum number of results to return per call (10 to 50). Defaults to 10.
MIRO_GET_TAGTool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.2 params

Tool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.

Parameters* required
board_idstring
Unique identifier of the board where the tag resides.
tag_idstring
Unique identifier of the tag to retrieve.
MIRO_LIST_ORGANIZATIONSTool to retrieve list of organizations accessible to the user. Use when you need to view all available organizations.

Tool to retrieve list of organizations accessible to the user. Use when you need to view all available organizations.

No parameter schema in public metadata yet.

MIRO_UPDATE_APP_CARD_ITEMTool to update an app card item on a board. Use when you need to modify properties of an existing app card item. Include only fields to change.7 params

Tool to update an app card item on a board. Use when you need to modify properties of an existing app card item. Include only fields to change.

Parameters* required
board_idstring
ID of the board containing the app card item
dataobject
Core data for an app card item.
geometryobject
Geometrical dimensions for an app card item.
item_idstring
ID of the app card item to update
parentobject
Parent frame reference for nesting an app card item.
positionobject
Board position for an app card item.
styleobject
Styling options for an app card item.
MIRO_UPDATE_BOARDTool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists.6 params

Tool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists.

Parameters* required
board_idstring
Unique identifier (ID) of the board to update
descriptionstring
New description for the board (up to 300 characters)
namestring
New name for the board (1-60 characters)
policyobject
Defines permissions and sharing policies for the board
projectIdstring
ID of the project (space) to which the board should be added
teamIdstring
ID of the team where the board should be placed

Sponsors

Configuration

MIRO_ACCESS_TOKEN

Miro API access token with boards:read and boards:write permissions

Readme

Miro MCP Server

Run your Miro workshops, retros, and planning sessions from the command line. Read boards, create stickies, organize frames, and generate diagrams through Claude, Cursor, or any MCP client.

Community project — Not officially affiliated with Miro. See official options below.

110 tools | Single binary | All platforms | All major AI tools


View the full README on GitHub

Details

Repository
github.com/olgasafonova/miro-mcp-server
Category
Design & Creative
Package
ghcr.io/olgasafonova/miro-mcp-server:1.25.0
Transport
STDIO
Registry
MCP registry, active

More from olgasafonova

Related Design & Creative MCP servers

View all
1rudraptpsingh avatarFigbridgerudraptpsingh/figbridgeFree, local MCP bridge for Figma — HTML, CSS, Tailwind, tokens, agent handoff bundles.15stars
2fboldo avatarOpenSCADfboldo/openscad-mcp-serverRender STL and PNG from OpenSCAD code.8stars
3dushyant30suthar avatarEndiagram Mcpdushyant30suthar/endiagram-mcpEN Diagram — structural verification for concurrent systems. Pure math, no AI.7stars
4getcutpro avatarCutProgetcutpro/mcpCreate images, videos, music, voices, sound effects and 3D with any AI model, plus AI video clips.0stars
5paradoxsyn avatarPolymationparadoxsyn/rivemcp-releasesAuthor Rive; convert Lottie, After Effects, Animate and Figma into it; animate AI and pixel art.0stars
6forge-space avatarBranding Mcpforge-space/branding-mcpAI-powered brand identity generation via MCP with design tokens, typography, and logo assets.1stars