io.github.vkhanhqui/figma-mcp-go

Add a new page to the Figma document.

Add a new mode to an existing variable collection (e.g. Light/Dark, Desktop/Mobile). IMPORTANT — Figma free plan only allows 1 mode per collection; calling this tool on a free-plan account will return the error 'Limited to 1 modes only'. If that error occurs, stop retrying and switch to the name-prefix workaround: keep the single default mode and create variables prefixed by mode, e.g. 'light/color-bg' and 'dark/color-bg' in the same collection. Tell the user that native multi-mode variables require a paid Figma plan (Professional or above).

Apply an existing local style (paint, text, effect, or grid) to a node, linking the node to that style.

Rename multiple nodes using find/replace, regex substitution, or prefix/suffix addition.

Bind a local variable to a node property so the property is driven by the variable's value. COLOR variables: use fillColor or strokeColor. BOOLEAN variables: use visible. FLOAT variables: use opacity, rotation, width, height, cornerRadius, topLeftRadius, topRightRadius, bottomLeftRadius, bottomRightRadius, strokeWeight, itemSpacing, paddingTop, paddingRight, paddingBottom, paddingLeft.

Clone an existing node, optionally repositioning it or placing it in a new parent.

Convert an existing FRAME node into a reusable COMPONENT. The frame is replaced in place by the new component.

Create a new local effect style (drop shadow, inner shadow, or blur).

Create a new ellipse (circle/oval) on the current page or inside a parent node.

Create a new frame on the current page or inside a parent node.

Create a new local layout grid style.

Create a new local paint style with a solid fill color.

Create a new rectangle on the current page or inside a parent node.

Create a Figma Section node on the current page. Sections are the modern way to organize frames and groups on a page.

Create a new text node on the current page or inside a parent node. The font is loaded automatically before insertion. Returns the created node ID and bounds. Use set_text to update the content of an existing text node.

Create a new local text style (typography preset). Returns the new style's ID. Apply it to nodes with apply_style_to_node. Use get_styles to list existing text styles.

Create a new variable (design token) inside an existing collection. Returns the new variable's ID. Use get_variable_defs to find collection IDs, set_variable_value to set values per mode, and bind_variable_to_node to apply the variable to a node property.

Create a new local variable collection with an optional initial mode name. NOTE — Figma free plan limits each collection to 1 mode. If you need Light/Dark (or any multi-mode) theming and the user is on the free plan, do NOT try to call add_variable_mode; instead use the name-prefix workaround: create all variables in a single collection and prefix each variable name with its mode, e.g. 'light/color-bg' and 'dark/color-bg'. Inform the user of this limitation.

Delete one or more nodes. This cannot be undone via MCP — use with care.

Delete a page from the Figma document. Cannot delete the only remaining page.

Delete a style (paint, text, effect, or grid) by its ID.

Delete a single variable (provide variableId) or an entire collection and all its variables (provide collectionId). Provide exactly one of the two — not both.

Detach one or more component instances, converting them to plain frames. The link to the main component is broken; all visual properties are preserved.

Export multiple frames as a single multi-page PDF file. Each frame becomes one page in order. Ideal for pitch decks, proposals, and slide exports.

Export all design tokens (variables and paint styles) as JSON or CSS custom properties. Ideal for bridging Figma variables into your codebase.

Find and replace text content across all TEXT nodes in a subtree. Searches the entire current page if no nodeId is given.

Get dev-mode annotations in the current document or scoped to a specific node. Returns annotation objects with label text, measurement type, and the ID of the annotated node. Omit nodeId to retrieve all annotations on the current page.

Get a depth-limited, token-efficient tree of the current selection or page. Use this instead of get_document when exploring large files. Supports detail levels (minimal/compact/full) and dedupe_components for pages heavy with repeated component instances.

Get the full node tree of the current page (not the whole file — only the active page). Returns all nodes recursively and can be very large. Prefer get_design_context for exploration or when token efficiency matters.

List all fonts used in the current page, sorted by usage frequency. Useful for understanding typography without scanning all text nodes.

Get all components defined in the current Figma file.

Get metadata about the current Figma document: file name, pages, current page

Get a single node by ID with full detail. Use get_nodes_info to fetch multiple nodes in one round-trip instead of calling this repeatedly. Node ID must be colon format e.g. '4029:12345', never hyphens.

Get full details for multiple nodes by ID in one round-trip. Prefer this over calling get_node repeatedly when you need several nodes.

List all pages in the document with their IDs and names. Lightweight alternative to get_document.

Get the prototype reactions defined on a node. Returns an array of reaction objects — each has a trigger (e.g. ON_CLICK, ON_HOVER, AFTER_TIMEOUT) and an actions array (navigate to node, open URL, go back, etc.). Use set_reactions to add or replace reactions, remove_reactions to delete them.

Export a screenshot of one or more nodes as base64-encoded image data (held in memory). Use save_screenshots instead when you want to write images directly to disk without base64 in the response.

Get the nodes currently selected in Figma. Returns an empty array if nothing is selected. Use get_design_context or get_node to retrieve deeper detail about a specific node by ID.

Get all local styles in the document (paint, text, effect, and grid). Returns each style's ID, name, type, and properties. Use the style ID with apply_style_to_node or update_paint_style. For design tokens (variables), use get_variable_defs instead.

Get all local variable definitions: collections, modes, and values. Variables are Figma's design token system.

Get the current Figma viewport: scroll center, zoom level, and visible bounds.

Group two or more nodes into a GROUP. All nodes must share the same parent.

Import a base64-encoded image into Figma as a rectangle with an image fill. Use get_screenshot to capture images or provide your own base64 PNG/JPG.

Lock one or more nodes to prevent accidental edits in Figma.

Move one or more nodes to an absolute canvas position. The same x/y is applied to every node independently (not a relative offset from current position).

Switch the active Figma page. Provide either pageId or pageName.

Remove prototype reactions from a node. Omit indices to remove all reactions. Provide a zero-based indices array to remove specific reactions (use get_reactions first to see current indices).

Rename a single node by ID. Returns the updated node with its new name. Use batch_rename_nodes to rename multiple nodes at once or to apply find/replace patterns across many nodes.

Rename an existing page in the Figma document.

Change the z-order (layer stack position) of one or more nodes.