Repository navigation
Releases
v1.6.0
The plugin changed in this release. Close it in Figma and run it again from Menu > Plugins > Development; Figma then loads the new code.js.
Added
-
create_node_treeandupdate_nodeswrite in the format thatget_node_inforeads. An agent that had read a design could not write it back. No tool set FILL or HUG sizing, absolute positioning, constraints, stroke alignment or mixed-style text.create_textused only Inter. Colors were read as hex but written as 0-1 floats in three different shapes. Rebuilding one card took about 22 sequential calls, and the result was still wrong.create_node_treebuilds a node and its whole subtree in one call and returns the ID of every node it created. Aget_node_inforesult, edited or not, is a valid input.update_nodeschanges the given properties of several existing nodes in one call.- Both accept hex colors and resolve
fontWeightto each family's own style name (Inter "Semi Bold", Poppins "SemiBold"). - Both validate the whole spec before changing anything and name the path of each error.
- Both report every property that was not applied as a warning. A failed build removes what it created.
-
lockedin the node format.get_node_inforeportslocked: true, andcreate_node_treeandupdate_nodesset it.rectangleCornerRadiiinupdate_nodestakesnullfor a corner to keep, so one call can change some corners only. With these,update_nodescoversset_node_properties,set_corner_radiusandset_font_weight. -
get_visual_snapshottakesregion, a part of the node in px from the top-left of its bounding box. A tall page was scaled to fit 2000 px, so a 1440 x 9879 px section rendered at 0.2x; a region renders at the requested scale. When a snapshot is scaled down, the result suggests a region. The plugin exports the region through a temporary slice, which it removes. -
get_styled_text_segmentstakesproperties, up to 10 style properties in one call. A segment ends where any of them changes.propertystill takes one. -
get_csstakesmaxNodes(default 200, up to 1000) forrecursive=true.
Fixed
-
create_node_treewas tested in Figma, and these problems were fixed. The rebuilt test nodes include a 125-node section and a 122-node rotated group.- An absolute child with a RIGHT or BOTTOM constraint moved when its HUG parent grew while later siblings were added: a badge placed at 170, 150 landed at 330, 300. Positions, constraints and rotation are now applied after the whole tree is built.
- A rotated GROUP was rotated twice, because its children's rotation already includes the group's. A group is now built unrotated and placed at its children's box. In the 122-node group, rotated -147.7 degrees, every node lands within 0.01 px of the original.
- A clone inside a rotated group kept a rotation relative to the group. Clones and instances now always get their rotation, 0 included.
- Figma's defaults for new nodes differed from what an omitted field means in
get_node_infooutput. New auto-layout frames included strokes in the layout, new drop shadows were shown behind the node, and the counter axis of a new auto-layout frame stayed fixed. These values are now set explicitly. An omitted sizing mode hugs, unlesslayoutSizing*or a width or height says otherwise. - Clones were resized to the size they already had, which turned a 0 px wide vector into 0.01 px.
- When Figma listed no fonts, text failed with
font family "Inter" is not available in Figma. The error now says that Figma lists no fonts (seen with figma-linux), and an unknown family names up to 5 similarly spelled families.
-
create_node_treeandupdate_nodeswere tested with text in Figma, and these problems were fixed. The tests rebuilt a 738-node section with 64 text nodes and 69 nodes with effects, and ran 144 combinations of text sizing modes.- Node fills were applied after the text runs and replaced their colors: words set in orange in the original came out in the text's base color. Node properties are now applied before the text.
update_nodesset every run to one font when onlyfontFamilychanged, so semibold words became regular. AfontWeightin a style or run withoutfontFamilyfailed. The server now reads the node's fonts withget_node_info, asset_font_weightdoes. A family alone keeps each run's weight and slant, and a weight alone keeps each run's family.- NOISE, TEXTURE and GLASS effects were skipped with a warning. They are now passed through, and
get_node_inforeads their settings from the plugin, because Figma's JSON export gives GLASS as its type alone. All 69 effects of the section were rebuilt unchanged.
-
Image contrast in
get_node_infooutput was 0.3 times the value Figma uses. The REST format scales contrast by 0.3 (0.9 exports as 0.27); the other six filters are unscaled. The value is now converted, so it matchesset_image_filtersandcreate_node_tree. -
set_font_weightfailed for families that spell style names differently from Inter. It mapped weights to Inter's names, so 600 asked Poppins, Montserrat or Open Sans for "Semi Bold", while they have "SemiBold". It now resolves the weight against the node's own family, the waycreate_node_treedoes, and keeps italic. When the family has no style of that weight, it uses the closest one and names it. Throughbatch_operations, which bypasses the server, the plugin matches Inter's name to the family's style while ignoring spaces and case. -
rest_get_filereported rotation in radians with the opposite sign. It now reports degrees, asget_node_infodoes. -
rotate_nodedescribed its angle as clockwise. Figma's rotation is counterclockwise. -
get_node_info,get_nodes_infoandrest_get_fileno longer discard layout and styling. The node filter kept 10 properties and dropped the rest. Agents therefore had to infer auto-layout from coordinates, rendered hidden layers, merged mixed-style text into one style, and lost stroke weights, per-corner radii, effects, opacity and clipping. The tree now includes:- Auto-layout and child sizing:
layoutMode, padding,itemSpacing, alignment, sizing modes,layoutSizingHorizontal/layoutSizingVertical,layoutPositioningand constraints. visible: falsestubs for hidden layers.- Clipping, opacity and blend mode.
- Stroke weight, alignment and dashes, and
rectangleCornerRadii. - Effects.
- The full text style, with
textRunsfor mixed-style text. imageRefon image fills.parentOffset, the position relative to the parent's bounding box.
Values equal to Figma's defaults are omitted, and lengths are rounded to 2 decimals. The change is in the MCP server only; the plugin does not need to be re-imported.
- Auto-layout and child sizing:
-
get_node_infoon a vector node returned an error, because vector nodes were removed from the tree. They are now returned like other nodes. -
create_textreported success when its font failed to load, and left an Inter Regular node at the default size. It now returns the error and creates nothing. -
create_rectangle,create_frameandcreate_textdeclaredparentIdoptional, although the relay rejects creation without it. The schemas now require it.
Deprecated
- 24 tools that
create_node_treeandupdate_nodescover. These are the single-property setters (set_fill_color,set_stroke_color,set_gradient,set_effects,set_auto_layout,move_node,resize_node,rename_node,set_node_properties,set_corner_radius,set_font_name,set_font_weight,set_font_size,set_line_height,set_paragraph_spacing,set_text_align,set_text_case,set_text_decoration), the text content setters (set_text_content,set_multiple_text_contents) andcreate_frame,create_rectangle,create_ellipseandcreate_text. They still work. Each description now begins with "Deprecated: use ..." and names the replacement field, and COMMANDS.md, section 3 lists the mapping. Removing them in a later release shrinks thetools/listresponse from 104 tools and 90,599 characters to 80 tools and 67,035 characters, 26% less (measured without a REST token). Three tools are kept:rotate_node(a relative angle),set_letter_spacing(percent) andset_image_filters(works without the image hash). - The
design_strategy,text_replacement_strategyandaudit-accessibilityprompts, and the README examples, no longer name deprecated tools.
Changed
compare_to_figmareports where the render differs. It compared on a grid of 120 cells across (12 design px per cell at 1440 px) and called 80% SSIM or more a close match. On a 1440 x 765 px section, moving the headline by 8 px still scored 96.7%, and a font size 2 px larger scored 90.6%, so both were "close". Now:- Grid cells cover 4 design px (120 to 600 cells across).
- A cell differs when its structural mismatch exceeds 0.5 or a color channel of its mean differs by more than 60 of 255. The 1x snapshot of the unchanged section differs from its 2x snapshot by 31 at most. Moving a text or a 54 px circle by 2 px, and changing a color, a font or a font size, each exceeded 60.
- Up to 5 hot spots, clusters of differing cells, are listed as boxes in design px from the node's top-left and in canvas coordinates, largest first, with the differing area in percent.
- "Close match" now also requires no hot spots. The diff heatmap shows color differences as well as structural ones, and is at most about 2400 px on its longer side.
get_csswithrecursive=trueskips hidden layers (it included them, although they are not rendered), indents each block by its depth below the requested node, and gives the text of text nodes. The number of skipped hidden layers is reported.- The
export-to-tailwindandread_design_strategyprompts and theget_node_info, `ge...
v1.5.0
First release of the standalone repository Alkaness/talk-to-figma-mcp.
Security
- Relay binds to
127.0.0.1by default: Bun's default bind address is every interface, so the unauthenticated relay was reachable from the local network and any host on it could read or modify the open Figma file (the origin allowlist only stops browsers).FIGMA_SOCKET_HOST=0.0.0.0restores network access and is now required for Windows + WSL; the Docker image sets it inside the container. The MCP server now connects tows://127.0.0.1to match.
Changed
- New npm package
@alkaness/talk-to-figma-mcp. The commands are nownpx @alkaness/talk-to-figma-mcp(launcher) andnpx -p @alkaness/talk-to-figma-mcp@latest talk-to-figma-mcp-server(MCP server). The packageclaude-talk-to-figma-mcpbelongs to the original project and does not contain these changes; client entries that use it must be replaced (see INSTALLATION.md, section 4). - Renamed to Talk to Figma: the Claude Desktop extension (
talk-to-figma-mcp.dxt, display name "Talk to Figma"), the Figma plugin name (its ID is unchanged, so an existing import keeps working), the messages shown to the agent, and the documentation. The suggested client configuration key isTalkToFigmaand the MCP server reports itself asTalkToFigmaMCP. - Author is Alkaness; the original authors are listed as contributors in
package.json. - Documentation rewritten in a formal style: numbered sections, exact figures, no emojis.
COMMANDS.mdis regenerated from the source and now covers all 107 tools (29 were missing), 5 prompts and 2 resources.readme.mdis renamed toREADME.md, andTESTING.mdis merged intoCONTRIBUTING.md. - Docker instructions publish the relay on
127.0.0.1:3055only.
Fixed
- Release workflow:
dxt packnames its output after the checkout folder, which no longer matched the.dxtfile the workflow uploaded, so releases received no asset. The package is now written to the fixed nametalk-to-figma-mcp.dxtwith the pinned@anthropic-ai/dxtdevDependency, and the artifact upload fails when the file is missing. configure-claudeproduced an invalid bin name for a scoped package and suggested a relay command that requires Bun; it now usestalk-to-figma-mcp-serverand the launcher.
Removed
context/(the original author's development notes),images/(banner and unreferenced screenshots),prompts/(unlinked UX/UI prompt files),smithery.yamlandTESTING.md.- The
iconfield in the DXTmanifest.json, which pointed at the removed banner. Claude Desktop shows its default extension icon.
Install
- Claude Desktop: download
talk-to-figma-mcp.dxtbelow and open it. - Other clients: see INSTALLATION.md.