miro_list_boardsLABSCO SUMMARY
110 tools is a lot of context — the essentials profile is the setting most people should change first.
The full surface costs roughly 20,795 tokens of preload on every session. Setting MIRO_TOOLS_PROFILE to essentials registers a curated 15-tool subset at about 2,848 tokens and leaves miro_tool_search as the way to reach everything else on demand — a saving the repository puts at 86.2%. Beyond that, the two capabilities worth knowing about are Mermaid-to-flowchart, which turns a text diagram into a real board object, and the SVG round trip, which lets a board be read out and written back as vector code.
What it is
A Go server, shipped as a single binary, covering the Miro REST API across 110 tools: boards, items, frames, diagrams, comments, tags, groups and exports.
What you get
- Boards: miro_list_boards, miro_find_board, miro_create_board, miro_copy_board, miro_update_board, miro_delete_board and member sharing
- Items: stickies, shapes, text, cards, app cards, images, documents and frames — with miro_create_sticky_grid and miro_bulk_create for many at once
- Diagrams: flowcharts and sequence diagrams generated from Mermaid, plus miro_list_diagrams and miro_get_diagram for native ones
- Frames: miro_create_frame, miro_get_frame_items, miro_update_frame and miro_delete_frame for organising a board into regions
- Mindmaps with parent-child structure, connectors with styled arrows, and grouping
- SVG in and out: miro_read_board_svg, miro_create_from_svg and miro_update_from_svg
- Comments: create, list, reply and resolve
- Uploads of local images and documents, board thumbnails through miro_get_board_picture, and export jobs for PDF and SVG
- miro_tool_search — find the right tool by keyword or category, weighted across name, title, category and description
- A companion miro-workflow skill describing how to assemble sprint boards, retros, brainstorms, story maps and kanban from the atomic tools
Requirements
A Miro app token with boards:read and boards:write, in MIRO_ACCESS_TOKEN. Install through Homebrew, a one-line script, a Docker image or a native binary — there is no runtime to install alongside it. This is a community project, not affiliated with Miro; PDF and SVG export are Miro Enterprise features.
Setup effort
One command plus a key — brew tap olgasafonova/tap && brew install miro-mcp-server, then supply credentials
USE CASES
01
Setting up a retro board before the meeting starts
Frames, column headings and starter stickies created in one pass rather than dragged into place.
02
Turning a diagram you described in text into a board object
Write it as Mermaid and get a real flowchart on the board, editable by everyone else afterwards.
03
Reading what is already on a board
Pull the board content or a summary so the assistant can work from what the team put there.
04
Adding an idea to the board without opening Miro
One sticky, in the right frame, from wherever the conversation is happening.
05
Keeping the session's context cost down
Run the essentials profile and let the assistant look up any other tool it needs by keyword.
06
Closing out comments after a review
List the open comments, reply where needed, and resolve the rest.
110 tools
Listed in project docs. Your client may show a different list.
miro_find_boardmiro_get_boardmiro_get_board_summarymiro_get_board_contentmiro_create_boardmiro_copy_boardmiro_update_boardmiro_delete_boardmiro_list_board_membersmiro_get_board_membermiro_share_boardmiro_update_board_membermiro_remove_board_membermiro_create_stickymiro_create_sticky_gridmiro_create_shapemiro_create_flowchart_shapemiro_create_textmiro_create_framemiro_create_cardmiro_create_app_cardmiro_create_imagemiro_upload_imagemiro_upload_documentmiro_create_docmiro_create_documentmiro_create_embedmiro_create_connectormiro_create_groupmiro_create_mindmap_nodemiro_bulk_createmiro_get_framemiro_update_framemiro_delete_framemiro_get_frame_itemsmiro_get_mindmap_nodemiro_list_mindmap_nodesmiro_delete_mindmap_nodemiro_create_code_widgetmiro_get_code_widgetmiro_list_code_widgetsmiro_update_code_widgetmiro_move_code_widgetmiro_delete_code_widgetmiro_create_commentmiro_list_commentsmiro_get_commentmiro_reply_commentmiro_resolve_commentmiro_read_board_svgmiro_create_from_svgmiro_update_from_svgmiro_list_itemsmiro_list_all_itemsmiro_get_itemmiro_get_imagemiro_get_documentmiro_get_app_cardmiro_get_docmiro_search_boardmiro_who_am_imiro_update_itemmiro_update_stickymiro_update_shapemiro_update_textmiro_update_cardmiro_update_imagemiro_update_image_from_filemiro_update_documentmiro_update_document_from_filemiro_update_embedmiro_update_groupmiro_update_app_cardmiro_bulk_updatemiro_delete_itemmiro_delete_app_cardmiro_update_docmiro_delete_docmiro_bulk_deletemiro_create_tagmiro_list_tagsmiro_get_tagmiro_attach_tagmiro_detach_tagmiro_get_item_tagsmiro_get_items_by_tagmiro_update_tagmiro_delete_tagmiro_list_connectorsmiro_get_connectormiro_update_connectormiro_delete_connectormiro_list_groupsmiro_get_groupmiro_get_group_itemsmiro_delete_groupmiro_get_board_picturemiro_create_export_jobmiro_get_export_job_statusmiro_get_export_job_resultsmiro_list_tablesmiro_get_tablemiro_tool_searchmiro_generate_diagrammiro_list_diagramsmiro_get_diagrammiro_get_audit_logmiro_get_org_audit_logsmiro_get_desire_pathsBEFORE YOU INSTALL
What to know first
Tools you get
110 tools named in the project's documentation.
Requires
MIRO_ACCESS_TOKEN in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
brew tap olgasafonova/tap && brew install miro-mcp-serverMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add miro -e MIRO_ACCESS_TOKEN=<YOUR_MIRO_ACCESS_TOKEN> -- miro-mcp-serverCursor
CURSOR · IN CLIENT
/add-plugin miroOther routes
Docker
DOCKER · TERMINAL
docker run -e MIRO_ACCESS_TOKEN=<YOUR_MIRO_ACCESS_TOKEN> -p 8080:8080 miro-mcp-server
