Miro MCP Server

An experimental Model Control Protocol (MCP) server for interacting with the Miro API and a single board.

Overview

This project provides a FastMCP server that exposes Miro API endpoints as tools that can be used by AI agents. It automatically generates tool definitions from the Miro OpenAPI specification, allowing AI agents to manipulate Miro boards programmatically.

Features

• Support for all major Miro board item types:
  • Sticky notes
  • Shapes
  • Text
  • Images
  • Cards
  • App cards
  • Documents
  • Embeds
  • Connectors

Prerequisites

• Node.js
• A Miro account with API access
• A Miro API token
• A Miro board ID

Installation without Docker

1. Clone the repository:

   git clone https://github.com/yourusername/mcp-server-miro.git
   cd mcp-server-miro
   

2. Install dependencies:

   npm install
   

3. Create a .env file in the root directory with the following variables:

   MIRO_API_TOKEN=your_miro_api_token
   MIRO_BOARD_ID=your_miro_board_id
   
   # Optional, port
   PORT=3000
   

Usage

1. Start the server:

   npm run dev
   

   or

   npm run build
   npm start
   

2. The server will start at http://localhost:8899/sse

3. AI agents can now use the exposed Miro API tools through the MCP protocol

Using with Docker

# The exact command depends on your Docker version
docker compose up -d
docker-compose up -d

# Server should be up in default port or the one you chose

API Tools

The server exposes the following Miro API endpoints as tools:

Board Operations:

• get_specific_board: Retrieves information about the current board.
• update_board: Updates the current board.

Generic Item Operations:

• get_items: Retrieves a list of items on the board (supports filtering and pagination).
• update_item_position_or_parent: Updates the position or parent of a specific item.
• delete_item: Deletes a specific item (covers various types like sticky notes, text, shapes, etc.).

Sticky Note Operations:

• create_sticky_note_item: Adds a sticky note.
• get_sticky_note_item: Retrieves a specific sticky note.
• update_sticky_note_item: Updates a specific sticky note.

Text Operations:

• create_text_item: Adds a text item.
• get_text_item: Retrieves a specific text item.
• update_text_item: Updates a specific text item.

Shape Operations:

• create_shape_item: Adds a shape item.
• get_shape_item: Retrieves a specific shape item.
• update_shape_item: Updates a specific shape item.

Card Operations:

• create_card_item: Adds a card item.
• get_card_item: Retrieves a specific card item.
• update_card_item: Updates a specific card item.

Connector Operations:

• create_connector: Adds a connector between items.
• get_connectors: Retrieves a list of connectors.
• get_connector: Retrieves a specific connector.
• update_connector: Updates a specific connector.
• delete_connector: Deletes a specific connector.

Document Operations:

• create_document_item_using_url: Adds a document item from a URL.
• update_document_item_using_url: Updates a document item added from a URL. (Note: Getting specific documents is handled by get_items)

Embed Operations:

• create_embed_item: Adds an embed item from a URL.
• update_embed_item: Updates an embed item. (Note: Getting specific embeds is handled by get_items)

Image Operations:

• create_image_item_using_url: Adds an image item from a URL.
• update_image_item_using_url: Updates an image item added from a URL. (Note: Getting specific images is handled by get_items)

App Card Operations:

• create_app_card_item: Adds an app card item.
• update_app_card_item: Updates an app card item. (Note: Getting specific app cards is handled by get_items)

License

MIT