Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.13.2 (2026-06-18), so it may lag behind newer releases.
Save images and vector assets from Figma to local project files.
Present at v0.6.5
Good to know
Supports PNG, SVG, and GIF; paths must resolve inside the configured image directory. Path containment is lexical and does not prevent symlink escapes.
Access Figma through HTTP using a personal access token supplied per request.
Since v0.12.0
Good to know
HTTP requests may provide a personal token or OAuth bearer token; absent request credentials use server credentials. Stdio and fetch need startup credentials.
Resolve node `template` references through top-level `elements`; accept inline style objects as well as style keys and allow missing node `type` and `name`. Text-layer and auto-generated names are omitted.
Action requiredInferredAffects: Scripts and library consumers parsing simplified node and style output.
Requested roots use contextual sizing with designed dimensions for reference; letter spacing and relative line height use `em`, and stroke alignment distinguishes inset, centered, and outside strokes.
Use relative `localPath` values or absolute paths inside `IMAGE_DIR`; outside absolute paths and Windows drive-letter paths on POSIX are now rejected. Remove a leading slash if a relative path was intended.
Action requiredAffects: Clients relying on absolute paths being silently treated as relative paths.
Set `--format` and server `OUTPUT_FORMAT` only to `yaml`, `json`, or `tree`; invalid configured values now fail instead of silently falling back. Remove invalid environment values even when a CLI format is supplied.
Action requiredInferredAffects: Configurations with unsupported output-format values.
Without proxy settings, the server uses Node's default dispatcher. Set `--proxy=none` or `FIGMA_PROXY=none` to bypass environment proxies; 403 errors include response details and bypass guidance.
Pass parsed flags to `getServerConfig(flags)`, then pass the returned configuration to `startServer(config)`; both functions previously took no arguments.
Action requiredInferredAffects: Applications importing getServerConfig or startServer.
Set `--image-dir` or `IMAGE_DIR` to the intended base and pass relative `localPath` values; absolute paths no longer select arbitrary destinations. Use only letters, digits, underscores, dots, or hyphens in `filenameSuffix`.
Action requiredInferredAffects: Clients supplying absolute download paths or filenameSuffix values outside the allowed characters.
Replace `SSEClientTransport` with `StreamableHTTPClientTransport`; use POST at `/mcp` or `/sse`. Stop using `/messages`, GET/DELETE streams, and persistent `mcp-session-id` state.
Action requiredInferredAffects: Legacy SSE clients and clients relying on persistent HTTP sessions.
Call `getServerConfig()` without the old Boolean argument; await `simplifyRawFigmaObject` and `extractFromDesign`. Pass a server factory as the third argument to `startHttpServer`.
Action requiredInferredAffects: Applications consuming the exported configuration, extraction, or HTTP server APIs.
Give coding tools Figma grid layouts with rows, columns, gaps, and cell placement intact.
Details
Grid layout output now preserves placement rather than flattening it. MCP output defaults to tree and shares repeated element bodies; fetch retains its YAML default, and serialized output omits text-layer and auto-generated names.
Also: Tree becomes the MCP default; repeated data is shared, HTTP accepts OAuth bearer tokens, SVGs report dimensions, and colors, blur, and text units are corrected.
Install [email protected]; requires Node.js >=20.20.0 and Figma API credentials.
Added: Read Figma grid rows, columns, gaps, and per-cell p…Now stable / inferred: Read Figma design context as a compact indented tre…Action required / inferred: Read Figma file or node layouts, styles, text, and…Action required / inferred: Read Figma file or node layouts, styles, text, and…Behavior changed: Read Figma file or node layouts, styles, text, and…Now works / inferred: Read Figma file or node layouts, styles, text, and…Improved: Access Figma through HTTP using a personal access t…Now works: Save images and vector assets from Figma to local p…
Send a separate Figma personal access token with each HTTP request.
Details
HTTP requests accept X-Figma-Token without a globally configured credential. Tree output is opt-in, while image paths must resolve within the configured image directory and invalid output-format values fail validation.
Also: Experimental tree output, stricter image paths and format validation, recovered layout details, and a fix for late progress notifications.
Install [email protected]; requires Node.js >=20.20.0 and Figma API credentials.
Added: Access Figma through HTTP using a personal access t…Added: Read Figma design context as a compact indented tre…Action required: Save images and vector assets from Figma to local p…Now works: Save images and vector assets from Figma to local p…Now works / inferred: Read Figma file or node layouts, styles, text, and…Now works: Read Figma file or node layouts, styles, text, and…Action required / inferredAction required / inferred: Embed Figma design extraction or MCP serving in a N…
Preserve inline formatting and nested lists when passing Figma text to coding tools.
Details
Text output now carries Markdown emphasis, links, strikethrough, lists, and style references for other inline differences. The server also supports --proxy=none and uses Node's default dispatcher when no proxy is configured.
Install [email protected]; requires Node.js >=20.20.0 and Figma API credentials.
Added: Read Figma text with bold, italic, links, strikethr…Behavior changed: Retrieve Figma data and images through an HTTP prox…
Fetch simplified Figma design data directly from the command line for scripts and pipelines.
Details
The fetch subcommand accepts a Figma URL or file/node flags and prints YAML or JSON. This group also introduces proxy configuration and opt-out telemetry, and raises the package's declared minimum Node version to 20.20.0.
Also: Proxy support, Boolean and text component properties, corrected style collisions, startup fixes, default telemetry, and a newer Node requirement.
Install [email protected]; requires Node.js >=20.20.0 and Figma API credentials.
Added: Fetch Figma design data from a shell and pipe YAML…Added: Retrieve Figma data and images through an HTTP prox…Added: Inspect Boolean and text properties and conditional…Now works: Read Figma file or node layouts, styles, text, and…Now works: Read Figma file or node layouts, styles, text, and…Action required / inferredBehavior changedAction required / inferred: Embed Figma design extraction or MCP serving in a N…Action required / inferred: Inspect Boolean and text properties and conditional…
Keep receiving progress while large Figma designs and image downloads are processed.
Details
Tools send progress when clients provide a progress token; clients that reset timeouts on progress can keep long requests alive. HTTP now uses stateless Streamable HTTP, and image downloads resolve under --image-dir or IMAGE_DIR.
Also: Animated GIF downloads, configurable image destinations, SVG and layout fixes, and stateless HTTP connections.
Install [email protected]; requires Node.js >=18.0.0 and Figma API credentials.
Improved / inferred: Read Figma file or node layouts, styles, text, and…Improved: Save images and vector assets from Figma to local p…Action required / inferred: Save images and vector assets from Figma to local p…Limit lifted / inferred: Connect MCP clients to a Figma context server over…Action required / inferred: Connect MCP clients to a Figma context server over…Action required / inferred: Embed Figma design extraction or MCP serving in a N…
Choose the network address on which the Figma HTTP server listens.
Details
The server accepts --host or FRAMELINK_HOST, retaining 127.0.0.1 as the default. FRAMELINK_PORT takes precedence over PORT, and the exported HTTP startup function now takes a host argument.
Install [email protected]; requires Node.js >=18.0.0 and Figma API credentials.
Improved / inferred: Connect MCP clients to a Figma context server over…Action required / inferred: Embed Figma design extraction or MCP serving in a N…
v0.6.5 Starting point with v0.2.2, v0.3.0, v0.3.1, v0.4.0, v0.4.1, v0.4.2, v0.4.3, v0.5.0, v0.5.1, v0.5.2, v0.6.0, v0.6.1, v0.6.2, v0.6.3, v0.6.4
Give an MCP coding tool the layout, styling, text, and component data from a Figma file or selected node.
Details
This baseline records capabilities available at the start of the release window: simplified design context, image downloads, HTTP or stdio connections, and library exports.
Install [email protected]; requires Node.js >=18.0.0 and Figma API credentials.
Added: Read Figma file or node layouts, styles, text, and…Added: Save images and vector assets from Figma to local p…Added: Connect MCP clients to a Figma context server over…Added / inferred: Embed Figma design extraction or MCP serving in a N…