Miro

Attach an existing tag to a sticky note or card. The tag must already exist; create it first with miro_create_tag if needed. Only sticky_note and card items support tags. USE WHEN: "tag this sticky as Urgent", "add the Done label", "mark this card with Priority" FAILS WHEN: tag_id doesn't exist on this board (list with miro_list_tags), item is not a sticky_note or card. VOICE-FRIENDLY: "Tagged sticky with 'Urgent'"

Create multiple items at once (max 20). For creating only stickies in a grid, use miro_create_sticky_grid instead. USE WHEN: "add these 5 stickies", "create items for each of these", "batch add" ITEM FIELDS: - type (required): sticky_note, shape, text - content, x, y, width, height, color, parent_id: standard fields - shape: shape type (when type=shape) - text_color: text color (shape and text items only) - font_size: font size in points (shape and text items only; default 14) - text_align: horizontal text alignment (shape items only): left, center, right - text_align_vertical: vertical text alignment (shape items only): top, middle, bottom RETURNS: Count of created items and their IDs (returned in input order even when API IDs are assigned out of order). FAILS WHEN: More than 20 items. Empty items list. Individual items may fail while others succeed; check errors in response. VOICE-FRIENDLY: "Created 5 items on the board"

Delete multiple items at once (max 20). WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Count of deleted items and their IDs. FAILS WHEN: More than 20 items. Empty items list. Individual items may fail while others succeed; check errors in response. VOICE-FRIENDLY: "Deleted 5 items from the board"

Update multiple items at once (max 20). Only provide fields you want to change. USE WHEN: "update positions for these items", "rename these stickies", "move several items into a frame", "center the text on these shapes". ITEM FIELDS: - item_id (required): ID of the item to update - type (optional but recommended): 'shape', 'sticky_note', or 'text'. When set, the update routes to the type-specific endpoint and accepts type-specific fields like text_align. When omitted, falls back to the generic /items endpoint (cross-type fields only). - content, x, y, width, height, color, parent_id: cross-type fields, accepted regardless of type - text_color: shape and text items (requires type=shape or type=text) - text_align: shape items (requires type=shape): left, center, right - text_align_vertical: shape items (requires type=shape): top, middle, bottom RETURNS: Count of updated items and their IDs. FAILS WHEN: More than 20 items. Empty items list. Individual items may fail while others succeed; check errors in response. VOICE-FRIENDLY: "Updated 5 items on the board"

Copy an existing Miro board. USE WHEN: "copy this board", "duplicate board", "make a copy of X board" RETURNS: New board ID, name, and view link. VOICE-FRIENDLY: "Copied board to 'Sprint Planning Copy'"

Create an app card with custom fields and status indicators. For simple cards with due dates, use miro_create_card instead. USE WHEN: "create an app card", "add a card with fields", "create a custom card" RETURNS: App card ID and view link. VOICE-FRIENDLY: "Created app card 'Integration Status'"

Create a new Miro board. USE WHEN: "create a board", "new board", "make a board for X" RETURNS: Board ID, name, and view link. VOICE-FRIENDLY: "Created board 'Sprint Planning'"

Create a card on a Miro board. Cards have title, description, and due dates. For cards with custom fields and status, use miro_create_app_card. USE WHEN: "add a card", "create a task card", "card with due date" RETURNS: Card ID, title, and view link. VOICE-FRIENDLY: "Created card 'Review design specs'"

Create a code widget: a syntax-highlighted code snippet on the board. Uses v2-experimental API. May change or become unavailable before GA. USE WHEN: "add a code snippet", "put this code on the board", "create a code block" PARAMETERS: - code: The source code (max 6000 characters). Required. - language: For syntax highlighting (e.g. javascript, go, python). Optional. - title: Widget header text (max 100 characters). Optional. RETURNS: Widget ID and view link. FAILS WHEN: code exceeds 6000 characters. board_id not found. Account lacks access to the experimental API.

Open a comment thread on a board, optionally attached to a specific item. Uses a v2-experimental API that Miro ships undocumented; it may change or become unavailable without notice. USE WHEN: "comment on this board", "leave feedback on that sticky", "add a note for the team on item X" PARAMETERS: - board_id: Required. - content: Required. First message of the thread. - item_id: Optional. Attaches the thread to an item; without it the comment lands at the board origin (the API ignores position coordinates on create). RETURNS: Thread ID, and the item ID when attached. VOICE-FRIENDLY: "Added a comment on the pricing sticky"

Create a connector line between two items. Styles: straight, elbowed (default), curved. Caps: none, arrow, stealth, diamond, filled_diamond, oval, filled_oval, triangle, filled_triangle. USE WHEN: "connect these items", "draw a line from A to B", "link items together", "add an arrow" RETURNS: Connector ID and view link. FAILS WHEN: start_item_id or end_item_id don't exist on the board. Both endpoints are required.

Create a rich text document on a Miro board from Markdown content. USE WHEN: User says "add a document", "create a doc from markdown", "put markdown on the board" PARAMETERS: - board_id: Required - content: Markdown text (required). Supports headings, lists, bold, italic, links, code blocks. - x, y: Position - parent_id: Frame ID to place doc in EXAMPLE: {"board_id": "uXjVN1234", "content": "# Sprint Goals\n- Ship v2.0\n- Fix critical bugs"} RELATED: Use miro_get_doc to read doc content. Use miro_delete_doc to remove. For URL-based documents, use miro_create_document instead. VOICE-FRIENDLY: "Created doc format item on board"

Add a document (PDF, etc.) to a Miro board from a URL. URL must be publicly accessible. USE WHEN: "add a document from URL", "put a PDF on the board", "add a reference document" RETURNS: Document ID, title, and view link. RELATED: To upload a local file instead, use miro_upload_document.

Embed external content as a live preview on a Miro board. Supports YouTube, Vimeo, Figma, Google Docs, Loom, and other oEmbed providers. For static images from URL, use miro_create_image. For document references from URL, use miro_create_document. USE WHEN: "embed this YouTube video", "add a Figma link", "embed Google Doc", "put a Loom video on the board" RETURNS: Embed ID, URL, provider name, and view link.

Export boards to PDF, SVG, or HTML. ENTERPRISE ONLY. RETURNS: Export job ID and initial status. Poll with miro_get_export_job_status. FAILS WHEN: Not on Enterprise plan. No board_ids provided. More than 50 boards. Invalid format (must be pdf, svg, or html).

Create a flowchart shape using the experimental API. Supports additional stencil shapes beyond the standard shape tool. USE WHEN: User says "create a flowchart shape", "add a process box", "draw a decision diamond for flowchart" For standard shapes, use miro_create_shape instead. This tool uses the v2-experimental API for flowchart-specific stencil shapes. PARAMETERS: - board_id: Required - shape: Shape type (required). Supports: rectangle, round_rectangle, circle, rhombus, parallelogram, trapezoid, pentagon, hexagon, star, flow_chart_predefined_process, wedge_round_rectangle_callout, etc. - content: Text inside the shape - x, y: Position - width, height: Size (default 200x200) - fill_color: Fill color (hex like #006400) - border_color: Border color (hex like #000000) - parent_id: Frame ID RETURNS: Item ID, shape type, content, and view link. NOTE: Uses v2-experimental API. Shape types may change when this moves to GA.

Create a frame container to group items visually. For logical grouping without a visual border, use miro_create_group. USE WHEN: "create a frame", "add a container", "make a section for X" PARAMETERS: - color: Background color. Accepts a 6-char hex like "#006400" or a named color: red, orange, yellow, green, blue, purple, pink, gray, white, black. Note: frames use a smaller palette than stickies; sticky-only names like 'light_yellow' or 'light_green' are NOT valid for frames (use a hex value or a base named color instead). RETURNS: Frame ID, title, and view link. EXAMPLE: {"board_id": "uXjVN1234", "title": "Q1 Goals", "width": 800, "height": 600, "color": "green"}

Create board items from an SVG document, parsed locally. Supported elements: rect (-> rectangle shape; rx>0 -> round_rectangle; data-type="sticky" -> sticky note with data-content text; data-type="frame" -> frame with data-title), circle and ellipse (-> circle shape), polygon with 3 points (-> triangle shape), text (-> text item), image with a public href (-> image item), line with data-start/data-end referencing other elements' id attributes (-> connector, created after the referenced items; data-caption -> label), g with transform="translate(x,y)" (offset applied to children, nesting supported). Fill colors carry over. Unsupported elements (path, multi-point polygon, ...) are itemized in the response as skipped, never silently dropped. USE WHEN: "put this SVG on the board", "recreate this wireframe as board items", importing a diagram from a tool that exports SVG. NOT FOR: pixel-faithful SVG import (Miro has no vector item type; this maps to native shapes), Mermaid diagrams (use miro_generate_diagram), or editing existing items (use miro_update_from_svg). PARAMETERS: - board_id, svg: Required. SVG source, max 1 MiB, max 200 drawable elements per call. - offset_x, offset_y: Optional placement offset for the whole batch. RETURNS: created (id, type, source element per item), skipped (element + reason), count. On a mid-batch failure the created list still names every item that landed, so the caller can verify or clean up.

Group multiple items together logically (minimum 2). Grouped items move and resize together. For a visible container with a border and title, use miro_create_frame. USE WHEN: "group these items", "bundle items together", "make a group" RETURNS: Group ID and member item IDs. VOICE-FRIENDLY: "Grouped 4 items together"

Add an image to a Miro board from a URL. USE WHEN: User says "add an image", "insert picture from URL", "put this image on the board" PARAMETERS: - board_id: Required - url: Image URL (must be publicly accessible, required) - title: Alt text / title - width: Image width (preserves aspect ratio) - x, y: Position NOTE: The image URL must be publicly accessible. Private URLs won't work. FAILS WHEN: URL is not publicly accessible or returns 404. board_id not found. RELATED: To upload a local file instead, use miro_upload_image.

Create a mindmap node. Omit parent_id for root; add parent_id for children. USE WHEN: "add a mindmap node", "create root node", "add child to mindmap" LAYOUT: Multiple children of the same parent stack at the same default position if x/y are omitted. To avoid overlap when creating siblings, supply explicit x/y for each child (canvas-absolute coordinates). For a fully manual tree, prefer miro_create_shape + miro_create_connector with explicit positions. PARAMETERS: - node_view: Currently only "text" is reliably supported. Other values may return 400. - x, y: Required for root nodes. Optional for children, but recommended when creating multiple siblings to override the API's default placement. RETURNS: Node ID, parent node ID, and view link. FAILS WHEN: parent_id references a non-existent node on the board. board_id not found.

Create a shape on a Miro board. USE WHEN: User says "add a rectangle", "draw a circle", "create a box for X" SHAPE TYPES: - Basic: rectangle, round_rectangle, circle, triangle, rhombus - Flow: parallelogram, trapezoid, pentagon, hexagon, star - Flowchart: flow_chart_predefined_process, wedge_round_rectangle_callout PARAMETERS: - board_id: Required. Get from list_boards or find_board - shape: Shape type (required, default: rectangle) - content: Text inside shape - color: Fill color. 6-char hex like "#FF5733" or named: red, orange, yellow, green, blue, purple, pink, gray, white, black. - text_color: Text color, same format as color. - text_align: Horizontal text alignment: left, center (default), right. - text_align_vertical: Vertical text alignment: top, middle (default), bottom. For non-rectangular shapes (triangle, hexagon), 'middle' aligns to the bounding-box center, which is not the same as the visual centroid. - x, y: Position (default: 0, 0) - width, height: Size (default: 200, 200) RETURNS: Item ID, shape type, position, size, and view link. RELATED: For flowchart-specific stencil shapes (experimental API), use miro_create_flowchart_shape instead. EXAMPLE: {"board_id": "uXjVN1234", "shape": "circle", "content": "Start", "color": "green", "text_align": "center", "x": 0, "y": 0}

Create a sticky note on a Miro board. For multiple stickies in a grid, use miro_create_sticky_grid. For batch creation of mixed items, use miro_bulk_create. USE WHEN: "add a sticky", "create note saying X", "put a yellow sticky" RETURNS: Item ID, content, color, and view link. FAILS WHEN: Content is empty. board_id not found. VOICE-FRIENDLY: "Created yellow sticky 'Action item: Review design'"

Create multiple sticky notes arranged in a grid layout (max 50). For mixed item types, use miro_bulk_create. USE WHEN: "add a grid of stickies", "create 6 stickies in rows", "make sticky notes for each idea" VOICE-FRIENDLY: "Created 9 stickies in a 3x3 grid"

Create a tag on a Miro board. Colors: red, magenta, violet, blue, cyan, green, yellow, gray, light_green, dark_green, dark_blue, dark_gray, black. VOICE-FRIENDLY: "Created red tag 'Urgent'"

Add free-floating text to a Miro board with no background or border. For notes with colored backgrounds, use miro_create_sticky. For rich Markdown documents, use miro_create_doc. USE WHEN: "add a title", "put heading text", "write a label", "add text saying X" RETURNS: Item ID, content, and view link.

Delete an app card from a Miro board. WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted app card ID. VOICE-FRIENDLY: "App card deleted successfully"

Delete a Miro board permanently. USE WHEN: "delete this board", "remove the board", "get rid of board X" WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted board ID.

Delete a code widget from a board. Uses v2-experimental API. May change or become unavailable before GA. WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted widget ID.

Delete a connector from a Miro board. USE WHEN: "delete this connector", "remove this line", "disconnect these items" WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted connector ID. VOICE-FRIENDLY: "Connector deleted successfully"

Delete a doc format item from a Miro board. USE WHEN: User says "remove the document", "delete that doc" PARAMETERS: - board_id: Required - item_id: Doc format item ID to delete (required) - dry_run: If true, returns preview without deleting (optional) WARNING: This action cannot be undone. Use dry_run=true to preview what will be deleted before executing. RELATED: Use miro_get_doc to inspect before deleting. Use miro_create_doc to create new documents.

Delete a frame from a Miro board. Items inside are NOT deleted; they become ungrouped. WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted frame ID. VOICE-FRIENDLY: "Frame deleted successfully"

Delete a group. Set delete_items=true to also delete items (default: items are released to move independently). USE WHEN: deleting a group OR ungrouping items. With delete_items=false (default), items are ungrouped and remain on the board. With delete_items=true, both the group and its items are permanently deleted. WARNING: Deleting items (delete_items=true) cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted group ID. VOICE-FRIENDLY: "Group deleted, items ungrouped"

Delete an item from a Miro board. USE WHEN: "delete this item", "remove this sticky", "get rid of this shape" WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted item ID.

Delete a mindmap node. Deleting a parent may affect children. Uses v2-experimental API. WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted node ID.

Delete a tag from a board. Removes the tag from all items. USE WHEN: "delete this tag", "remove tag from board", "get rid of tag X" WARNING: Cannot be undone. Use dry_run=true to preview first. RETURNS: Confirmation with deleted tag ID. VOICE-FRIENDLY: "Tag deleted successfully"

Remove a tag from a sticky note or card. The tag stays on the board for reuse; to delete it entirely, use miro_delete_tag. USE WHEN: "remove the Urgent tag", "untag this card", "take off the Done label"

Find a Miro board by name (case-insensitive, partial match). Returns board ID for subsequent operations. For listing all boards, use miro_list_boards. USE WHEN: "find board named X", "get the Design Sprint board" RETURNS: id, name, description, view_link, team_id, team_name, owner (id + name), created_at, modified_at. Answers "who owns this board" and "when was it last changed" without a follow-up miro_get_board. VOICE-FRIENDLY: "Found 'Design Sprint' board - ready to work on it"

Generate a diagram on a Miro board from Mermaid code. Parses locally (no external service), creates shapes and connectors with auto-layout. USE WHEN: "create a flowchart", "generate diagram from code", "draw a process flow", "make a sequence diagram" NOT FOR: Freeform shape placement (use miro_create_shape). Mindmaps (use miro_create_mindmap_node). SUPPORTED SYNTAX: - flowchart/graph (directions: TB, BT, LR, RL): A[rect] --> B{diamond} -->|label| C((circle)) - sequenceDiagram: participant A; A->>B: sync; A-->>B: async OUTPUT MODES: - discrete (default): Individual shapes and connectors, no container - grouped: All items in a logical group for easy move/delete - framed: All items inside a titled frame PARAMETERS: - board_id: Required - diagram: Mermaid code (required). Must start with "flowchart TB", "graph LR", or "sequenceDiagram". - output_mode: "discrete" (default), "grouped", or "framed" - use_stencils: true for professional flowchart symbols (terminator, process, decision, I/O) - start_x, start_y: Position offset (default: 0, 0) - parent_id: Frame ID to place diagram inside RETURNS: Counts of created nodes/connectors/frames, all item IDs and view links, diagram dimensions. In grouped/framed mode, also returns container ID. FAILS WHEN: Invalid Mermaid syntax (returns line number and fix suggestion). Missing header (must start with flowchart/graph/sequenceDiagram). Input exceeds 50KB or 500 lines. VOICE-FRIENDLY: "Created flowchart with 6 shapes and 5 connectors"

Get details of a specific app card by ID. RETURNS: App card ID, title, description, status, custom fields, and view link. VOICE-FRIENDLY: "App card 'API Status' shows 3 custom fields"

Query THIS SERVER's local execution log — which MCP tools ran here, when, and whether they succeeded. Covers this process only; it knows nothing about actions taken in Miro's UI or by other clients. USE WHEN debugging what this server did. For who did what in the Miro workspace, use miro_get_org_audit_logs instead. Filter by time range, tool, board, action type, or success/failure. RETURNS: Array of entries with timestamps, tool names, board IDs, and outcomes.