miro_create_shape
Add shapes like rectangles, circles, or triangles to Miro boards with custom text, colors, and positioning to visualize ideas and organize content.
Instructions
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 (e.g., "#FF5733" or color name)
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", "x": 0, "y": 0}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | Board ID | |
| shape | Yes | Shape type: rectangle, circle, triangle, rhombus, round_rectangle, etc. | |
| content | No | Text inside the shape | |
| x | No | X position | |
| y | No | Y position | |
| width | No | Width in pixels (default 200) | |
| height | No | Height in pixels (default 200) | |
| color | No | Fill/background color (hex like #006400) | |
| text_color | No | Text color (hex like #ffffff for white) | |
| parent_id | No | Frame ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| shape | Yes | ||
| content | No | ||
| message | Yes | ||
| item_url | No |