Connect Claude to Figma

Return the Figma user the token belongs to: id, handle, email and avatar. Call it to confirm which account a connection is acting as. It is the cheapest call here and takes no arguments, which is why it is the connection's health check.

List the projects inside one Figma team, with their ids and names. This is the top of the discovery chain: team id, then list_project_files for the file keys, then the file operations. The team id is the number in a Figma team URL - figma.com/files/team/1234567890/….

List the files in one project, each with the file key, name and last-modified time. The file key it returns is what every other operation here takes - a file key is not the same as the numeric project id, and it cannot be guessed from a file name. Get the project id from list_team_projects.

Fetch a file's document tree: pages, frames, and every layer with its geometry, styles and text. Start with depth 2 - that returns the pages and their top-level frames with node ids and nothing else, which is usually all you need to find the frame you actually care about. A full-depth call on a real design file is enormous and will exhaust your context; once you have the node id, call get_file_nodes for that subtree instead.

Fetch specific nodes from a file as structured JSON - one frame, one component, one screen - with their children, layout constraints, auto-layout padding and spacing, fills, strokes, effects and text styles. This is the operation to reach for when implementing a design: it gives an agent the actual measurements and tokens instead of a picture it has to guess from. Get node ids from get_file at a shallow depth, or from the node-id parameter of a Figma URL (convert the URL's 1-42 form to 1:42). Pair it with get_image_renders when you also want to see the frame.

Render nodes to images and return short-lived URLs, keyed by node id. Use it to actually look at a frame - png or jpg for a screenshot, svg for an icon you intend to copy into code, pdf for a print asset. The URLs expire after about 30 days, so treat them as something to fetch now rather than store. This shows what a design looks like; get_file_nodes tells you what it measures, and an implementation usually needs both.

List the components published from a file, with their key, node id, name, description and containing frame. This is the design system as the file declares it: call it before building any UI from a file so an implementation reuses the components a team already named - Button/Primary, Card/Elevated - instead of inventing parallel ones. Feed a component's node id to get_file_nodes for its structure, or to get_image_renders to see it. The file key must be the main file, not a branch: publishing does not happen from branches.

List the component sets published from a file - the variant groups, such as one Button set holding every size and state. Use it after get_file_components when a component name looks like it has variants: the set is what tells you which properties (size, state, icon) the component actually accepts. Main file key only, not a branch.

List the styles published from a file - colour, text, effect and grid styles - with their key, node id, name and description. These are the design tokens by the names the team uses. Read them before writing any CSS from a Figma design so the implementation refers to Brand/Primary rather than a hex code copied out of a node. Main file key only, not a branch.

List the comments on a file, with their author, timestamp, resolution state and the node or coordinate they are pinned to. Use it to find out what reviewers asked for on a specific frame before implementing it, and to get the comment id that post_comment needs in order to reply in the same thread rather than starting a new one.

List a file's version history, newest first, with each version's id, label, description and author. Use it to see what changed and when, and to take a version id you can then pass to get_file, get_file_nodes or get_image_renders to read the design as it stood at that point rather than as it is now.