Miro MCP Server

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

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

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

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)