Creates a new annotation or updates an existing one. Annotations are Figma’s native way to add design notes, implementation details, or any contextual information directly to design elements.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/grab/cursor-talk-to-figma-mcp/llms.txt
Use this file to discover all available pages before exploring further.
Parameters
The ID of the node to annotate (can be any visible node: FRAME, COMPONENT, INSTANCE, TEXT, etc.)
The annotation text in markdown format. Supports:
- Bold:
**text** - Italic:
*text* - Links:
[text](url) - Code:
`code` - Lists, headers, and more
The ID of an existing annotation to update. Omit to create a new annotation.
The ID of the annotation category. Use
get_annotations() with includeCategories: true to retrieve available categories.Additional properties for the annotation. Each property is an object with a
type field.Response
Returns a JSON object containing:success: Boolean indicating operation successannotationId: ID of the created or updated annotationnodeId: ID of the annotated nodemessage: Status message
Usage
Markdown Formatting Examples
Basic formatting
Structured annotations
Workflow: Single Node Annotation
Typical workflow for annotating a single element:Use Cases
Design specifications
Document design decisions and constraints:Implementation notes
Provide context for developers:Interactive prototyping notes
Document interaction behaviors:Best Practices
- Use structured markdown: Leverage headers, lists, and formatting for clarity
- Be concise: Keep annotations focused on essential information
- Link to docs: Use markdown links to reference external documentation
- Choose appropriate categories: Use categories to organize annotation types
- Update existing annotations: Use
annotationIdto update rather than duplicate
Related Tools
get_annotations
Retrieve existing annotations and categories
set_multiple_annotations
Batch annotate multiple nodes
scan_nodes_by_types
Find nodes that need annotations