# Figma

Read Figma files and nodes, render images, manage comments, projects, components. Exposes **20 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `figma_user_me` | Get the authenticated Figma user - GET /me. |
| `figma_get_file` | Get a file with all metadata - GET /files/&#123;file_key&#125;. |
| `figma_get_file_nodes` | Get specific nodes from a file - GET /files/&#123;file_key&#125;/nodes. |
| `figma_render_images` | Render nodes as images - GET /files/&#123;file_key&#125;/images. |
| `figma_get_image_fills` | Get all image fills in a file (used by nodes) - GET /files/&#123;file_key&#125;/images. |
| `figma_list_comments` | List comments on a file - GET /files/&#123;file_key&#125;/comments. |
| `figma_create_comment` | Create a comment on a file - POST /files/&#123;file_key&#125;/comments. |
| `figma_delete_comment` | Delete a comment - DELETE /files/&#123;file_key&#125;/comments/&#123;comment_id&#125;. |
| `figma_list_projects` | List projects in a team - GET /teams/&#123;team_id&#125;/projects. |
| `figma_list_project_files` | List files in a project - GET /projects/&#123;project_id&#125;/files. |
| `figma_list_team_projects` | List team projects - GET /teams/&#123;team_id&#125;/projects. |
| `figma_list_file_versions` | List file version history - GET /files/&#123;file_key&#125;/versions. |
| `figma_list_components` | Get all components in a file - GET /files/&#123;file_key&#125;/components. |
| `figma_get_component_set` | Get a specific component set - GET /component_sets/&#123;component_set_id&#125;. |
| `figma_list_styles` | List all styles in a file - GET /files/&#123;file_key&#125;/styles. |
| `figma_get_style` | Get a specific style - GET /styles/&#123;style_id&#125;. |
| `figma_list_variables` | List variables in a file - GET /files/&#123;file_key&#125;/variables. |
| `figma_list_webhooks` | List webhooks for a team - GET /teams/&#123;team_id&#125;/webhooks. |
| `figma_create_webhook` | Create a webhook subscription - POST /teams/&#123;team_id&#125;/webhooks. |
| `figma_delete_webhook` | Delete a webhook - DELETE /teams/&#123;team_id&#125;/webhooks/&#123;webhook_id&#125;. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Figma to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Figma API documentation](https://www.figma.com/developers/api)
