> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Figma

**Authentication:** OAuth or personal access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every design file in the `Mobile App` project modified this week.
* Pull the latest version of the `Onboarding` flow as PNG exports.
* Find every component in our design system that hasn't been used in any file in the last 90 days.

## Available Tools

#### get\_comments

Get all comments from a Figma file with author info, timestamps, and positioning metadata. Supports nested threads. Requires file\_key.

#### post\_comment

Create a new comment in a Figma file with specified message content and optional client metadata. Enables collaborative feedback and design review workflows through programmatic comment creation.

#### delete\_comment

Remove a specified comment from a Figma file. Requires valid comment\_id and file\_key parameters. Essential for comment moderation and cleanup workflows.

#### get\_comment\_reactions

Retrieve all reactions associated with a specific comment. Provides detailed reaction information including emoji types, user information, and reaction counts for engagement analysis.

#### post\_comment\_reaction

Add an emoji reaction to a specific comment. Enables automated engagement and feedback acknowledgment through programmatic reaction management.

#### delete\_comment\_reactions

Remove a specific emoji reaction from a comment. Essential for reaction management and cleanup workflows in collaborative design environments.

#### get\_team\_components

Get components from a team

#### get\_file\_components

Get components from a file

#### get\_component

Get details of a specific component

#### get\_team\_styles

Get styles from a team

#### get\_file\_styles

Get styles from a file

#### get\_style

Get details of a specific style

#### get\_dev\_resources

Get development resources from a file

#### delete\_dev\_resource

Delete a development resource

#### get\_file

Get Figma file content including document structure, pages, components, and styles. Optional parameters: version, node IDs, depth, geometry, plugin data, branch data.

#### get\_file\_nodes

Get specific nodes from a Figma file by node IDs. Requires file\_key and comma-separated ids. Optional: version, depth, geometry, plugin data.

#### get\_images

Export nodes from Figma file as images (PNG, JPG, SVG, PDF). Requires file\_key and node ids. Optional: scale, format, SVG settings. Returns download URLs.

#### get\_image\_fills

Get image fill references from a Figma file. Returns mapping of images to download URLs and metadata. Requires file\_key.

#### get\_file\_versions

Get version history of a Figma file with timestamps, authors, and version labels. Requires file\_key.

#### get\_file\_meta

Get lightweight file metadata (name, editor type, last modified, URL, access role) without downloading full document tree. Faster than get\_file. Requires file\_key.

#### get\_team\_projects

Get all projects for the authenticated team.

#### get\_project\_files

Retrieve all files contained within a specified project. Supports optional branch data inclusion for comprehensive file structure analysis. Essential for project content management and file discovery.

#### get\_webhook

Get webhook configuration including event type, endpoint URL, and status. Requires webhook\_id.

#### create\_webhook

Create webhook for Figma file notifications. Requires team\_id, event\_type, endpoint. Optional passcode. Supports FILE\_UPDATE, FILE\_DELETE, FILE\_VERSION\_UPDATE, LIBRARY\_PUBLISH events.

#### update\_webhook

Update webhook configuration including endpoint, event types, description, or passcode. Requires webhook\_id.

#### delete\_webhook

Delete a webhook subscription to stop notifications. Requires webhook\_id.

#### get\_team\_webhooks

Get all webhook configurations for a team including IDs, event types, endpoints, and status. Requires team\_id.