Read Figma files and comments from Guild agents

Integrations · Figma

Guild agents read Figma files and nodes, render frames as images, and read and post comments through the Figma REST API. Guild stores your Figma token and injects it server-side, so agent code never sees it. Credential policies decide which Figma operations each agent may call.

Book a demo

See how teams govern agents that use Figma.

Talk to sales

Get access to Guild, then connect Figma to your first agent.

What the Figma integration exposes

The integration is guildai~figma. Tools cover files, file nodes, image rendering, versions, comments and comment reactions, components, component sets, styles, variables, dev resources, projects, library analytics, and webhooks. Requests go to https://api.figma.com.

How it works

Create a Figma token

In Figma, open Settings > Security, then generate a personal access token under Personal access tokens. Choose an expiration and grant the scopes for the endpoints your agent calls.

Connect the token in Guild

Go to Access & setup > Credentials, click Connect, select figma, and paste the token into API Key.

Import the tools you need

Import FigmaTools from @guildai-services/guildai~figma and use pick() to give the agent only the tools its job needs.

Why Figma access needs governing

A Figma token can read every file its owner can open, and post or delete comments as that person. Guild keeps the token server-side and checks every request against your credential policies before it reaches Figma. A policy can let a review agent read files and post comments while denying deletes and webhook changes.

Authentication

Type: API key
Header: Guild sends the token as X-Figma-Token: <token>
Token: a Figma personal access token. When it expires, create a new one and reconnect it in Guild.

See Credentials for workspace, member, and agent-scoped credentials.

Usage

import { FigmaTools } from "@guildai-services/guildai~figma"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  systemPrompt: "You review Figma files and leave comments on unclear copy.",
  tools: {
    ...pick(FigmaTools, [
      "figma_get_file",
      "figma_get_file_nodes",
      "figma_get_comments",
      "figma_post_comment",
    ]),
  },
})

Tools are named with the figma_ prefix. The file_key most tools take is the ID in a Figma file URL, after /design/ or /file/.

Tools

Tools in the latest published version of guildai~figma:

All 55 tools

Tool	What it does
`figma_delete_comment`	Deletes a specific comment.
`figma_delete_comment_reaction`	Deletes a specific comment reaction.
`figma_delete_dev_resource`	Delete a dev resource from a file
`figma_delete_webhook`	Deletes the specified webhook.
`figma_get_activity_logs`	Returns a list of activity log events
`figma_get_ai_usage_daily`	Returns per-user, per-day AI credit usage for the plan associated with the calling token.
`figma_get_comment_reactions`	Gets a paginated list of reactions left on the comment.
`figma_get_comments`	Gets a list of comments left on the file.
`figma_get_component`	Get metadata on a component by key.
`figma_get_component_set`	Get metadata on a published component set by key.
`figma_get_developer_logs`	Returns a list of developer log entries for REST API and MCP server requests made within the organization.
`figma_get_dev_resources`	Get dev resources in a file
`figma_get_file`	Returns the document identified by `file_key` as a JSON object.
`figma_get_file_components`	Get a list of published components within a file library.
`figma_get_file_component_sets`	Get a list of published component sets within a file library.
`figma_get_file_meta`	Get file metadata
`figma_get_file_nodes`	Returns the nodes referenced to by `ids` as a JSON object.
`figma_get_file_styles`	Get a list of published styles within a file library.
`figma_get_file_versions`	This endpoint fetches the version history of a file, allowing you to see the progression of a file over time.
`figma_get_folder_files`	Get a list of the files directly within the specified folder.
`figma_get_folder_folders`	Get a list of the direct subfolders within the specified folder.
`figma_get_folder_meta`	Get metadata for a folder (name, thumbnail, file count, timestamps) without enumerating its files.
`figma_get_image_fills`	Returns download links for all images present in image fills in a document.
`figma_get_images`	Renders images from a file.
`figma_get_library_analytics_component_actions`	Returns a list of library analytics component actions data broken down by the requested dimension.
`figma_get_library_analytics_component_usages`	Returns a list of library analytics component usage data broken down by the requested dimension.
`figma_get_library_analytics_style_actions`	Returns a list of library analytics style actions data broken down by the requested dimension.
`figma_get_library_analytics_style_usages`	Returns a list of library analytics style usage data broken down by the requested dimension.
`figma_get_library_analytics_variable_actions`	Returns a list of library analytics variable actions data broken down by the requested dimension.
`figma_get_library_analytics_variable_usages`	Returns a list of library analytics variable usage data broken down by the requested dimension.
`figma_get_local_variables`	Get the local variables in a file, and remote variables it uses. Enterprise only.
`figma_get_me`	Returns the user information for the currently authenticated user.
`figma_get_oembed`	Returns oEmbed data for a Figma file or published Make site URL, following the oEmbed specification.
`figma_get_payments`	There are two methods to query for a user’s payment information on a plugin, widget, or Community file.
`figma_get_project_files`	List the files in a project. Deprecated; Figma recommends the folder endpoints.
`figma_get_project_meta`	Get a project’s metadata. Deprecated; Figma recommends the folder endpoints.
`figma_get_published_variables`	Get the variables published from a file. Enterprise only.
`figma_get_style`	Get metadata on a style by key.
`figma_get_team_components`	Get a paginated list of published components within a team library.
`figma_get_team_component_sets`	Get a paginated list of published component sets within a team library.
`figma_get_team_folders`	Get a list of the top-level folders (previously called “projects”) within the specified team.
`figma_get_team_projects`	List a team’s projects. Deprecated; Figma recommends the folder endpoints.
`figma_get_team_styles`	Get a paginated list of published styles within a team library.
`figma_get_team_webhooks`	Returns all webhooks registered under the specified team.
`figma_get_webhook`	Get a webhook by ID.
`figma_get_webhook_requests`	Returns all webhook requests sent within the last week.
`figma_get_webhooks`	Returns a list of webhooks corresponding to the context or plan provided, if they exist.
`figma_post_comment`	Posts a new comment on the file.
`figma_post_comment_reaction`	Posts a new comment reaction on a file comment.
`figma_post_dev_resources`	Bulk create dev resources across multiple files.
`figma_post_variables`	Create, update, or delete variables and collections in a file. Enterprise Editor seats only.
`figma_post_webhook`	Create a new webhook which will call the specified endpoint when the event triggers.
`figma_put_dev_resources`	Bulk update dev resources across multiple files.
`figma_put_webhook`	Update a webhook by ID.
`figma_receive_webhook_event`	Inbound Guild hook for the JSON body Figma POSTs to a webhook endpoint. event_type is PING, FILE_UPDATE, FILE_VERSION_UPDATE, FILE_DELETE, LIBRARY_PUBLISH, FILE_COMMENT, or DEV_MODE_STATUS_UPDATE.

Frequently asked questions

Can a Guild agent edit a Figma design?

No. The Figma REST API reads files and manages comments, variables, dev resources, and webhooks. It can’t move layers or change a design’s content.

Why does the variables tool return an error?

Figma only serves the variables endpoints to full members of Enterprise organizations. On other plans those tools fail.

Can a new Figma comment trigger a Guild agent?

Not yet. The integration includes Figma’s webhook management tools, but Guild doesn’t receive Figma events, so you can’t create an event trigger for Figma.

Also runs on Guild: GitHub · Linear · Jira Read: Docs: Credential policies · Credentials · Tools in agents

Overview

Models

Inference providers

Code & CI/CD

Communication

Project management

Testing

Design

Productivity

Monitoring & observability

Data

Web & search

Customer support

Sales & finance

Recruiting

Read Figma files and comments from Guild agents

Book a demo

Talk to sales

What the Figma integration exposes

How it works

Why Figma access needs governing

Authentication

Usage

Tools

Frequently asked questions

Book a demo

Talk to sales

​What the Figma integration exposes

​How it works

​Why Figma access needs governing

​Authentication

​Usage

​Tools

​Frequently asked questions

​Related

What the Figma integration exposes

How it works

Why Figma access needs governing

Authentication

Usage

Tools

Frequently asked questions

Related