Figma Connector

Connect Agentcy to your Figma workspace to import design files, components, styles, and variables into the knowledge graph — and interact with them through chat tools.

Overview

The Figma connector provides:

• Ingestion: Import projects, files, components, component sets, styles, variables, comments, and version history into the knowledge graph
• Live Tools (21): Interact with Figma in real-time — browse files, export images, manage comments, inspect components and styles, work with variables and dev resources

Setup

Prerequisites

• A Figma account (Free, Professional, Organization, or Enterprise)
• A Personal Access Token

Generate a Personal Access Token

1. Go to Figma Settings (click your avatar → Settings)
2. Scroll to Personal access tokens
3. Click Generate new token
4. Give it a descriptive name (e.g., "Agentcy")
5. Select the required scopes (file content read access at minimum)
6. Copy the token — it will only be shown once

Configuration Fields

Field	Required	Description
Personal Access Token	Yes	Your Figma PAT (starts with figd_...)
Team ID	No	Import all projects/files from a team. Find it in the URL: figma.com/files/team/<team_id>/...
File Keys	No	Comma-separated file keys for specific files. Find in URL: figma.com/design/<file_key>/...
Features	No	Select which modules to enable: files, components, styles, variables, comments, versions, images, dev_resources
Image Export Scale	No	Scale factor for image exports (0.01-4.0, default: 2)
Image Export Format	No	Format for exports: png, jpg, svg, pdf (default: png)

TIP

You can provide a Team ID to import everything from your team, or specify individual File Keys — or both. If neither is provided, only the authenticated user's info will be imported.

Ingestion

When syncing, the connector imports:

Record Type	Graph Label	Description
Projects	FigmaProject	Team projects
Files	FigmaFile	Design files with thumbnails
Components	FigmaComponent	Published components
Component Sets	FigmaComponentSet	Variant groups
Styles	FigmaStyle	Color, text, effect, grid styles
Variables	FigmaVariable	Design tokens (colors, numbers, strings, booleans)
Variable Collections	FigmaVariableCollection	Variable groupings
Comments	FigmaComment	File comments and threads
Versions	FigmaVersion	Named version history
User	FigmaUser	Authenticated user

Graph Relationships

• FigmaComponent → DEFINED_IN → FigmaFile
• FigmaStyle → DEFINED_IN → FigmaFile
• FigmaVariable → BELONGS_TO → FigmaVariableCollection
• FigmaVariable → DEFINED_IN → FigmaFile
• FigmaComment → COMMENTED_ON → FigmaFile
• FigmaComment → AUTHORED_BY → FigmaUser
• FigmaVersion → VERSION_OF → FigmaFile

Tools

Files (3 tools)

Tool	Description
figma_get_file	Get full file document tree, components, and styles
figma_get_file_nodes	Get specific nodes by ID
figma_get_file_meta	Get lightweight file metadata

Images (2 tools)

Tool	Description
figma_export_images	Export/render nodes as PNG, JPG, SVG, or PDF
figma_get_image_fills	Get download URLs for image fills in a file

Components (3 tools)

Tool	Description
figma_get_components	List published components (file or team level)
figma_get_component	Get single component details by key
figma_get_component_sets	List component sets / variant groups

Styles (2 tools)

Tool	Description
figma_get_styles	List published styles (file or team level)
figma_get_style	Get single style details by key

Variables (2 tools)

Tool	Description
figma_get_variables	Get all local variables and collections
figma_get_published_variables	Get published/shared variables

Comments (3 tools)

Tool	Description
figma_get_comments	Get all comments on a file
figma_post_comment	Post a comment (with optional node position)
figma_delete_comment	Delete a comment

Navigation (3 tools)

Tool	Description
figma_list_projects	List all projects in a team
figma_list_project_files	List files in a project
figma_get_versions	Get file version history

Dev Resources (2 tools)

Tool	Description
figma_get_dev_resources	Get linked dev resources on nodes
figma_create_dev_resource	Attach a URL to a design node

User (1 tool)

Tool	Description
figma_get_me	Get current user profile

Rate Limits

Figma API has rate limits that vary by plan tier. The connector handles 429 responses with automatic retry (up to 3 attempts with Retry-After header support). For large teams with many files, ingestion may take several minutes.

Example Chat Interactions

"Show me the components in our design system file"
"Export the hero section as a PNG at 2x"
"What comments are on the homepage design?"
"List all projects in our team"
"Post a comment on the login screen about the button spacing"
"Get the color variables from our tokens file"
"Show me the version history of the mobile app file"