io.github.neozhehan/figma-edit-mcp

Read the native annotations on a page or node (and subtree); exactly one of pageId or nodeId is required. The file's annotation categories are returned by default; pass includeCategories: false to omit them. Page loading is bounded; a page-scoped failure returns its structured error directly and successful reads include `coverage`.

Append native annotations to one or more nodes in a batched call. If the status is 'partial_success', treat it as an incomplete operation and report the failed and skipped items to the user. Appending is NOT idempotent and a 'failed' row may already have appended its annotation (verified counts differ, or outcomeUnknown is true when post-state is unreadable; both carry partialMutation: true) — before retrying any non-success item, call annotation_list and compare the labels already on the node, or you will create a duplicate.

Join a plugin channel to establish the live connection to the Figma document.

Remove a component-property definition from a main component or variant set; propagates to every instance.

List components in the document, with filtering and scope options. Document scans isolate page failures and report them in `coverage`; page-scoped failures return their structured error directly.

Add or edit a component-property definition (BOOLEAN/TEXT/INSTANCE_SWAP) on a main component or variant set. Deleting is `component_delete_property`.

Convert an existing frame into a main component.

Combine components into a component set (variants) with property definitions.

Create a frame (container) with optional fill/stroke and full auto-layout configuration.

Instantiate a component (by `componentKey` or `componentId`) at a position.

Create a rectangle, ellipse, polygon, or star via `type`, with position/size and optional `fillColor`/`strokeColor`. Shape-specific params (`arcData`; `pointCount`/`innerRadius`) validated by `type`. `pointCount` = sides (polygon) or points (star), native count — no even-parity rule.

Create a node from an SVG markup string.

Create a text node with content and optional font size/weight/color.

Read the override properties from a source instance, to later apply them to other instances.

Apply previously-read overrides to target instances; targets are swapped to the source component and all overrides applied. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

Set one property on an instance — boolean toggle, text override, instance swap, or variant selection.

Link a node to a shared library style (paint/text/effect/grid) by `styleId`. Use the raw `node_set_*` setters for ad-hoc values not backed by a style.

Bind a variable to a node property, or set an explicit variable mode. Use instead of a literal `node_set_*` when the value should track a design token. Ordering rules: set auto-layout before binding padding/spacing; set a solid fill before binding a colour token.

Duplicate an existing node, optionally at a new `x`/`y`. Produces a new node id.

Delete one or more nodes in a single batched, per-item-validated call. No API undo. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

Render a node to an image (PNG/JPG/SVG/PDF) at a given scale. Read-only; the canonical way to visually verify edits. SVG returns raw XML in `svg` (directly readable); PNG/JPG/PDF return base64 in `imageData` (PDF is a delivery artifact — prefer PNG/SVG for inspection).

Flatten a node and its children into a single vector. Lossy — original structure is not recoverable.

Wrap multiple nodes in a new group node.

Read one or more nodes — recursive subtree traversal with `properties` selection, `filter`, and `maxDepth`. Returns only the requested properties (incl. resolved `boundVariables`/`explicitVariableModes`) under each node's `properties` key. A node whose containing page could not be read is listed in `pageFailedNodes` with that page's ID, and the page's structured reason is in `coverage.pageErrors` — other pages still return normally. The workhorse read; start here before any write.

Reparent a node under a new parent at an optional `index`. Valid range is 0 to parent's child count. Omit `index` to append.

Rename a node (sets `name` to an exact value).

Configure a frame's auto-layout (mode, padding, spacing, alignment, sizing) in one unified setter.

Set a node's corner radius — uniform or per-corner.

Set a node's effect array (shadows, blurs). Use `node_apply_style` to link a shared effect style instead.

Set a node's fill to a literal RGBA color, an image, or clear it. Use `node_apply_style` to link a shared paint style, or `node_bind_variable` to bind a color token.

Set a node's stroke color and weight; supports uniform or per-side weights.

Move and/or resize a node by setting absolute `x`/`y`/`width`/`height` (any subset).

Dissolve a group, promoting its children to the parent. Removes the group container.

List the document's pages; no args → all pages (no children), or pass `pageIds` → those pages with their top-level children. Batch ≤25 ids/call. Inspect `coverage`: a failed page is omitted with a structured `pageErrors` row while other pages still return.

Read prototype reactions from one or more nodes and their descendants.

Replace a node's prototype reactions with a full new reactions array (read first via `reaction_list`).

Delete a local style by id. Detaches consumers — they keep their resolved values and lose only the style link.

List all local styles (paint/text/effect/grid) in the document.

Create a named style (paint/text/effect/grid), or update an existing one when `styleId` is given. UPDATE requires currentStyleName.

Set the text of one or more text nodes in a single batched, per-item-validated call. If the status is 'partial_success', treat it as an incomplete operation, report the failed and skipped items to the user, and retry every non-success item (both failed and skipped).

Set any combination of typography properties (font, size, weight, spacing, decoration, …) on a text node.

Delete specific variables or an entire collection. Runs a full-document consumer check first, before any removal: if a target is still in use the call is refused with VARIABLE_IN_USE, whose `details.variablesInUse` lists every consumer; if any page cannot be loaded and read it is refused with DOCUMENT_SCAN_INCOMPLETE, because a page error can never mean zero consumers.