Miro

You can run a lightweight MCP server that lets you control Miro whiteboards with AI through a single Go binary. It provides a large API surface, including bulk operations, mindmaps, tags, groups, and diagram generation, all accessible via an MCP client over HTTP or through local stdio-based execution.

How to use

Start by running the server in HTTP mode so your MCP client can connect over a standard URL and port. You can use an MCP client to list boards, create items, generate diagrams from Mermaid, and perform bulk operations across boards.

How to install

Prerequisites: a modern operating system (macOS, Linux, or Windows) and a compatible MCP client that supports HTTP or stdio integration. You will also need a Miro access token for API calls.

Install via Homebrew (macOS/Linux):

Install via one-liner (macOS/Linux):

Pull the Docker image and run it (recommended for quick setup):

Manual download and setup:

Additional configuration and running tips

Obtain a Miro access token by creating a new app at your Miro account with boards:read and boards:write permissions, then install it to your team and copy the token.

To run in HTTP mode with a port, pass the HTTP flag to the server when starting it. The server will listen for MCP protocol calls over HTTP.

Security and access control

Use a strong Miro access token and manage it securely. If you deploy in team or enterprise environments, restrict access to the MCP server endpoint and rotate tokens as part of your security hygiene.

Examples of use cases

Create boards and items in bulk, generate mindmaps from project ideas, attach tags to items, and export boards to PDFs or SVGs when supported by your plan.

Troubleshooting tips

If you encounter connectivity issues, verify that the MCP HTTP endpoint is reachable and that the Miro access token is valid. Check the server startup logs for authentication or rate-limiting messages.

Notes

This server provides a broad API surface intended for programmatic control of Miro boards via MCP clients. It emphasizes speed, small binary size, built-in diagram generation, and adaptive rate limiting.

Available tools

miro_list_boards

List accessible boards on the connected Miro account

miro_create_board

Create a new Miro board

miro_create_sticky

Create a sticky note on a board

miro_create_text

Create a text item on a board

miro_create_shape

Create a shape on a board

miro_create_frame

Create a frame container on a board

miro_create_card

Create a card with due date on a board

miro_create_app_card

Create an app card with custom fields

miro_create_image

Add image from URL to a board

miro_create_document

Add document from URL to a board

miro_create_export_job

Export board to PDF/SVG (Enterprise)

miro_generate_diagram

Create diagrams from Mermaid syntax

miro_list_items

List items on a board

miro_bulk_create

Create multiple items at once

miro_bulk_update

Update multiple items at once

miro_bulk_delete

Delete multiple items at once

miro_attach_tag

Attach a tag to an item

miro_share_board

Share board via email

miro_list_board_members

List users with access to a board

miro_get_board

Get details of a board

miro_delete_board

Delete a board

miro_get_audit_log

Query local execution log