This skill teaches how to use Miro MCP tools effectively for creating diagrams, documents, tables, and extracting context from Miro boards. Use when the user asks about Miro capabilities, wants to create content on Miro boards, or needs to work with Miro board data.
Creates and analyzes Miro board content including diagrams, documents, and tables.
npx claudepluginhub miroapp/miro-aiThis skill inherits all available tools. When active, it can use any tool Claude has access to.
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.
diagram_get_dsl - Get the DSL format specification before creating diagramsdiagram_create - Generate diagrams from DSL text descriptionsdoc_create - Create markdown documents on boardstable_create - Create tables with text and select columnstable_sync_rows - Add or update table rowsboard_list_items - List items on a board with filtering by type or containercontext_explore - Discover high-level board contents (frames, documents, prototypes, tables, diagrams)context_get - Extract detailed text context from specific board itemstable_list_rows - Read table data with column-based filteringimage_get_data - Get image content from boardsimage_get_url - Get download URL for an imagedoc_get - Read document content and versiondoc_update - Edit document using find-and-replaceMiro tools accept board URLs directly. Extract board_id and item_id automatically from URLs like:
https://miro.com/app/board/uXjVK123abc=/ - Board URLhttps://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345 - URL with item focusWhen a URL includes moveToWidget or focusWidget parameters, the item_id is extracted automatically.
Use diagram_create to create visual diagrams from text descriptions.
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] --> B{Valid Email?}
B -->|Yes| C[Send Verification]
B -->|No| D[Show Error]
C --> E[Wait for Confirm]
E --> F[Create Account]
Board coordinates use a Cartesian system with center at (0, 0). Positive X goes right, positive Y goes down.
Spacing recommendations:
Set parent_id to a frame ID to place content inside that frame.
Use doc_create to create Google Docs-style documents on boards.
# H1 through ###### H6**text***text*- item1. item[text](url)# Sprint Planning - Week 12
## Goals
- Complete user authentication module
- Fix critical bugs from QA
## Team Assignments
1. **Alice** - Auth backend
2. **Bob** - Frontend integration
3. **Carol** - Bug fixes
## Resources
- [Design specs](https://example.com/specs)
- [API documentation](https://example.com/api)
Use table_create to create tables with typed columns. Supports two column types: text for free-form entry and select for dropdowns with predefined color-coded options.
Use table_sync_rows to add or update table data. Set key_column to match existing rows for upsert behavior — matching rows are updated, non-matching rows are inserted as new.
Use table_list_rows to read table contents. Filter by column value using ColumnName=Value format.
Use context_explore to get a high-level view of what's on a board — returns frames, documents, prototypes, tables, and diagrams with their URLs and titles.
Use context_get to extract detailed content from specific items:
| Item Type | Returns |
|---|---|
| Documents | HTML markup of the document content |
| Prototype screens | HTML markup representing the UI/layout |
| Prototype containers | AI-generated map of all screens with navigation flow |
| Frames | AI-generated summary of frame contents |
| Tables | Formatted table data |
| Diagrams | AI-generated description and analysis |
context_explore to discover board contentscontext_get with specific item URLs (with moveToWidget parameter)Use board_list_items to explore board contents. Filter by item type (frame, sticky_note, card, shape, text, image, document, embed) or by container to list items within a specific frame.
context_explore to discover board contentscontext_get with item URLs for detailed content| Task | Tool |
|---|---|
| Get diagram DSL spec | diagram_get_dsl |
| Create diagram | diagram_create |
| Create document | doc_create |
| Read document | doc_get |
| Edit document | doc_update |
| Create table | table_create |
| Add/update table rows | table_sync_rows |
| Read table data | table_list_rows |
| Discover board contents | context_explore |
| Extract item details | context_get |
| List board items | board_list_items |
| Get image data | image_get_data |
| Get image URL | image_get_url |