Miro Board

Miro Board 🎨

Create diagrams, documents, tables on Miro boards and extract board content -- via MCP tools.

Setup

1. Miro Access Token

Get a token from Miro Developer Settings → REST API.

2. MCP Server Config

Add to your MCP config (.mcp.json, claude_desktop_config.json, or openclaw.json):

{
  "mcpServers": {
    "miro": {
      "command": "npx",
      "args": ["-y", "miro-mcp"],
      "env": {
        "MIRO_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

3. Alternative: Install via npx skills

npx skills add miroapp/miro-ai --skill=miro-mcp

MCP Tools

Content Creation

| Tool | Purpose | |---|---| | diagram_create | Flowcharts, mindmaps, UML, ER diagrams from text/Mermaid | | doc_create | Markdown documents on boards | | table_create | Tables with text and select columns | | table_sync_rows | Add/update table rows (upsert) | | diagram_get_dsl | Get DSL format spec before creating diagrams |

Content Reading

| Tool | Purpose | |---|---| | context_explore | Discover board contents (frames, docs, tables, diagrams) | | context_get | Extract detailed content from specific items | | board_list_items | List items with type/container filters | | table_list_rows | Read table data with column filters | | doc_get | Read document content + version | | image_get_data | Get image content |

Document Editing

| Tool | Purpose | |---|---| | doc_update | Edit document via find-and-replace |

Diagram Types

| Type | Use Case | Example | |---|---|---| | flowchart | Processes, workflows, decisions | User registration flow | | mindmap | Brainstorming, hierarchies | Product feature ideation | | uml_class | Class structures, inheritance | API model design | | uml_sequence | Component interactions | Auth flow sequence | | entity_relationship | Database schemas | Data model design |

Creating Diagrams

Natural language works:

User registration flow: start -> enter email -> validate email ->
send verification -> user confirms -> create account -> dashboard

Or Mermaid for precision:

flowchart TD
    A[Start] --> B{Valid Email?}
    B -->|Yes| C[Send Verification]
    B -->|No| D[Show Error]
    C --> E[Create Account]

Documents

Markdown → Miro document:

# Sprint Planning -- Week 12

## Goals
- Complete auth module
- Fix critical bugs

## Team
1. **Scotty** -- Implementation
2. **Rémy** -- Code Review
3. **Manni** -- PM + Triage

Tables

Create structured tables with typed columns (text or select with color-coded options). Use table_sync_rows with key_column for upsert behavior.

Board Context Extraction

Workflow:

1. context_explore → discover what's on the board
2. Pick items of interest
3. context_get → extract detailed content

| Item Type | Returns | |---|---| | Documents | HTML markup | | Prototype screens | UI/layout HTML | | Frames | AI-generated summary | | Tables | Formatted data | | Diagrams | AI-generated description |

Board URLs

Tools accept Miro URLs directly:

• https://miro.com/app/board/uXjVK123abc=/ -- board
• https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345 -- specific item

Positioning

Board coordinates: center at (0,0), X→right, Y→down.

| Content | Spacing | |---|---| | Diagrams | 2000-3000 units apart | | Documents | 500-1000 units | | Tables | 1500-2000 units |

Use parent_id to place content inside a frame.

Use Cases for Agents

| Scenario | Tools | |---|---| | Visualize architecture | diagram_create (flowchart/UML) | | Create project status board | table_create + doc_create | | Extract specs from design board | context_explore + context_get | | Generate meeting notes on board | doc_create | | Update project tracker table | table_sync_rows | | Create customer journey map | diagram_create (flowchart) | | Read existing board content | board_list_items + context_get |

---

v1.0 -- Based on miroapp/miro-ai. ManniTheRaccoon 2026-03-31. 🎨

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Yesterday-AI
• Source: Yesterday-AI/skills
• License: MIT
• Homepage: https://github.com/Yesterday-AI/skills

Install and usage instructions live in the source repository linked above.