# Miro

Connect an AI agent to Miro boards to inspect them, add items, and build diagrams. Useful for planning sessions and retrospectives.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 31
- Author: olgasafonova
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/olgasafonova/miro-mcp-server
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/olgasafonova-miro

## What it does

The server exposes 110 tools for working with boards and their contents. An agent can add sticky notes, shapes, text, cards, and documents, manage tags and groups, create mindmap nodes, and turn Mermaid descriptions into diagrams. It can also upload local images and documents to a board.

You need a Miro token with `boards:read` and `boards:write` permissions. The server runs in Docker and receives the token through `MIRO_ACCESS_TOKEN`. PDF and SVG board exports require Enterprise. This is a community project, not an official Miro product.

## Requirements
- Needs: Docker
- Environment variables: `MIRO_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MIRO_ACCESS_TOKEN=<MIRO_ACCESS_TOKEN> --transport stdio olgasafonova-miro -- docker run -i --rm -e MIRO_ACCESS_TOKEN ghcr.io/olgasafonova/miro-mcp-server:1.25.0
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add olgasafonova-miro --env MIRO_ACCESS_TOKEN=<MIRO_ACCESS_TOKEN> -- docker run -i --rm -e MIRO_ACCESS_TOKEN ghcr.io/olgasafonova/miro-mcp-server:1.25.0
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "olgasafonova-miro": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MIRO_ACCESS_TOKEN",
                "ghcr.io/olgasafonova/miro-mcp-server:1.25.0"
            ],
            "env": {
                "MIRO_ACCESS_TOKEN": "<MIRO_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "olgasafonova-miro": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MIRO_ACCESS_TOKEN",
                "ghcr.io/olgasafonova/miro-mcp-server:1.25.0"
            ],
            "env": {
                "MIRO_ACCESS_TOKEN": "<MIRO_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MIRO_ACCESS_TOKEN=<MIRO_ACCESS_TOKEN> olgasafonova-miro docker run -i --rm -e MIRO_ACCESS_TOKEN ghcr.io/olgasafonova/miro-mcp-server:1.25.0
```
Replace <…> with your own values

## When to use it
- add sticky notes and shapes to a board
- turn a Mermaid description into a diagram
- build a mindmap with parent-child nodes
- upload a local image or document to a board
- export a board as PDF or SVG with Enterprise

## Example prompts
- Add a yellow sticky note to the board that says “Review PRs.”
- Create a flowchart with a start, a decision, and an end.
- Make a mindmap with “Project Ideas” as its root.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md