create_item

Creates a text item: kind label (auto-sized text) or sticky (a sticky note with a colored background). Returns the new item id.

Tool name: create_item

Parameters

Parameter	Type	Required	Default	Description
projectId	string	Yes	—	Target project (map) id.
kind	string	Yes	—	"label" or "sticky".
text	string	Yes	—	Text content (plain text or HTML).
position	object	No	{ x: 0, y: 0 }	World-coordinate position of the item's top-left, { x, y }.
fontSize	number	No	Theme default	Font size in points. Must be ≥ 1.
fontFamily	string	No	Theme default	Font family name.
textColor	string	No	Theme default	Text color, hex e.g. "#FFFFFF".
backgroundColor	string	No	Theme default	Background color, hex.
horizontalTextAlignment	string	No	"Left"	"Left", "Center", or "Right".
verticalTextAlignment	string	No	"Top"	"Top", "Center", or "Bottom".
parentId	string	No	Project canvas	Container id to place the item under.

Returns

{ "created": true, "itemId": "11aa22bb-...", "kind": "sticky" }

Example

"Add a yellow sticky note that says 'Ship v2 by Friday'."

{
  "projectId": "a1b2c3d4-...",
  "kind": "sticky",
  "text": "Ship v2 by Friday",
  "position": { "x": 300, "y": 150 },
  "backgroundColor": "#FDE047",
  "textColor": "#1F2937"
}

To restyle the item later, use style_item; to change its text or move it, use update_item_property.