Skip to main content
Glama

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

TableJSON Schema
NameRequiredDescriptionDefault
board_idYesBoard ID
shapeYesShape type: rectangle, circle, triangle, rhombus, round_rectangle, etc.
contentNoText inside the shape
xNoX position
yNoY position
widthNoWidth in pixels (default 200)
heightNoHeight in pixels (default 200)
colorNoFill/background color (hex like #006400)
text_colorNoText color (hex like #ffffff for white)
parent_idNoFrame ID
Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/olgasafonova/miro-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server