figma_set_annotations
Writes or clears annotations on Figma nodes to document design specs for developers, supporting plain text, markdown, pinned properties, and categories.
Instructions
Write or clear annotations on a Figma node. Annotations communicate design specs to developers — use them to document animation timings, easing curves, interaction behaviors, accessibility requirements, and implementation notes. Supports plain text labels, rich markdown labels, pinned design properties, and annotation categories. Pass an empty array to clear all annotations. Use mode='append' to add to existing annotations, or mode='replace' (default) to overwrite. Requires Desktop Bridge plugin. This operation is undoable in Figma (Cmd+Z).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"nodeId": "<nodeId>",
"annotations": "<annotations>"
},
"name": "figma_set_annotations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | 'replace' (default) overwrites all existing annotations. 'append' adds new annotations while keeping existing ones. | replace |
| nodeId | Yes | Node ID to write annotations to (e.g., '695:313') | |
| annotations | Yes | Array of annotations to set. Each annotation can have a label (plain or markdown), pinned properties, and a category. Pass an empty array [] to clear all annotations. |