Miro MCP Server
About
An experimental Model Context Protocol (MCP) server that exposes Miro API endpoints as tools for AI agents, enabling programmatic manipulation of a single Miro board.
Details
- Author
- LuotoCompany
- Downloads
- 283
- Categories
- Other
Jump to
- Supports all major Miro board item types: sticky notes, shapes, text, images, cards, app cards, documents, embeds, and connectors
- Automatically generates tool definitions from the Miro OpenAPI specification
- Exposes board operations, item CRUD, and connector management as MCP tools
- Runs locally with Node.js or inside a Docker container
- Provides SSE transport for AI agent integration (default port 8899)
Start by cloning the repository, installing dependencies (npm install), and creating a .env file with your Miro API token, board ID, and optional port. Then run npm run dev or build and start with npm run build and npm start. The server listens at http://localhost:8899/sse; AI agents connect via MCP to use the exposed tools. Docker is also supported via docker compose up -d.
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
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
