set_annotation

Add or edit annotations on Figma design nodes using markdown text and category IDs to enhance design collaboration and clarity.

Instructions

Create or update an annotation

Input Schema

Name	Required	Description
`annotationId`	No	The ID of the annotation to update (if updating existing annotation)
`categoryId`	No	The ID of the annotation category
`labelMarkdown`	Yes	The annotation text in markdown format
`nodeId`	Yes	The ID of the node to annotate
`properties`	No	Additional properties for the annotation

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "annotationId": {
      "description": "The ID of the annotation to update (if updating existing annotation)",
      "type": "string"
    },
    "categoryId": {
      "description": "The ID of the annotation category",
      "type": "string"
    },
    "labelMarkdown": {
      "description": "The annotation text in markdown format",
      "type": "string"
    },
    "nodeId": {
      "description": "The ID of the node to annotate",
      "type": "string"
    },
    "properties": {
      "description": "Additional properties for the annotation",
      "items": {
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "nodeId",
    "labelMarkdown"
  ],
  "type": "object"
}

Talk to Figma MCP

set_annotation

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Talk to Figma MCP

Related Tools

MCP directory API