miro-mcp

# Using Miro with Claude Code

## What is Miro MCP?

Miro MCP (Model Context Protocol) enables Claude to interact directly with Miro boards. Create diagrams, documents, and tables; read board content; and extract structured documentation from visual designs.

## Available Tools

The Miro MCP provides these tool categories:

### Content Creation
- **`miro__draft_diagram_new`** - Generate diagrams from text descriptions
- **`miro__draft_doc_new`** - Create markdown documents on boards
- **`miro__table_create_new`** - Create tables with text and select columns
- **`miro__table_sync_rows`** - Add or update table rows

### Content Reading
- **`miro__board_get_items`** - List items on a board with filtering
- **`miro__context_get_board_docs`** - Extract typed documentation from boards
- **`miro__table_list_rows`** - Read table data with filtering
- **`miro__board_get_image_data`** - Get image content from boards

## Board URLs and IDs

Miro tools accept board URLs directly. Extract board_id and item_id automatically from URLs like:
- `https://miro.com/app/board/uXjVK123abc=/` - Board URL
- `https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345` - URL with item focus

When a URL includes `moveToWidget` or `focusWidget` parameters, the item_id is extracted automatically.

## Creating Diagrams

Use `miro__draft_diagram_new` to create visual diagrams from text descriptions.

### Supported Diagram Types
- **flowchart** - Process flows, workflows, decision trees
- **mindmap** - Hierarchical ideas, brainstorming
- **uml_class** - Class structures, inheritance relationships
- **uml_sequence** - Interactions between components over time
- **entity_relationship** - Database schemas, data models

### Description Formats

Natural language works well:
```
User registration flow: start -> enter email -> validate email ->
send verification -> user confirms -> create account -> redirect to dashboard
```

Mermaid notation for precise control:
```
flowchart TD
    A[Start] --