Figma Bridge MCP
This server lets AI coding agents read and edit the Figma file open in Figma Desktop through the Figma Plugin API.
Check the plugin connection and inspect the open file name/key, current page, and selection.
List all pages in the open file.
Get a lightweight outline of a node or page (id, name, type, box) to find node ids.
Export a node’s full JSON to disk in REST-style, compact, or auto format.
Render and save a node as PNG, JPG, SVG, or PDF.
Save original raster images used in image fills.
Run arbitrary Plugin API JavaScript to read and modify the open file, with
figmain scope, top-levelawait, andreturn.
Enables AI agents to read and edit the currently open Figma file through the Figma Desktop plugin API. Provides tools for checking connection/status, listing pages, retrieving node trees, exporting node JSON and images, exporting image fills, and running arbitrary Plugin API JavaScript for read and write operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Figma Bridge MCP Export the frame I selected in Figma as a PNG and save it locally"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Figma Bridge MCP
A local MCP server that lets AI coding agents (Claude, Codex, GitHub Copilot) read and edit the file you have open in Figma Desktop. It talks to Figma through a small development plugin instead of the REST API or Figma's hosted MCP, so:
it works on a View / Starter seat (the hosted MCP gives a handful of calls a month there),
there are no rate limits and no response truncation,
the agent can write to the file, not only read it (via
figma_run_script).

AI agent ──stdio──> figma-bridge (server.js) ──ws://127.0.0.1:3055──> plugin/ui.html ──postMessage──> plugin/code.js (Plugin API)The agent starts the server (npx -y @maxsbond/figma-bridge) as a stdio MCP server. The server opens a WebSocket on
127.0.0.1:3055 and waits. The "Figma Bridge" plugin, running in Figma Desktop,
connects to it and executes each request with the Plugin API in the open file.
Requirements
Node.js 18 or newer (the LTS installer is fine)
Figma Desktop (the browser version can't reach localhost from a dev plugin)
Edit access to the file. Figma doesn't run plugins in view-only files; if you only have view access, duplicate the file to your drafts.
Related MCP server: FreeMCP for Figma
Quick install
Paste this into Claude Code, Codex, Copilot or any other agent that can run terminal commands. It sets up everything except the two clicks in Figma, and tells you what those are.
Install Figma Bridge (https://github.com/MaxsBond/figma-bridge) for me:
1. Add the MCP server to your own MCP config: command `npx`, args `["-y", "@maxsbond/figma-bridge"]`. If the config file already exists, merge the entry instead of overwriting it.
2. Run `npx -y @maxsbond/figma-bridge setup` to copy the Figma plugin to ~/Documents/Figma Bridge Plugin.
3. Tell me how to import the plugin in Figma Desktop (Plugins → Development → Import plugin from manifest…, pick manifest.json from that folder) and how to run it in my file (Plugins → Development → Figma Bridge).
4. Tell me if I need to restart you. After the restart, call figma_status to check the connection.Prefer to do it by hand? Follow the steps below or the step-by-step guide.
Install
There are two parts: the MCP server, which your AI agent starts on its own, and the
Figma plugin, which you import into Figma once. The server is published on npm as
@maxsbond/figma-bridge, so
there is nothing to clone or build.
New to this? The step-by-step guide walks through the same setup with screenshots and tells you what to say to your agent.
1. Add the server to your agent
VS Code (GitHub Copilot): click Install in VS Code and confirm in VS Code. Other agents are in the sections below.
2. Set up the Figma plugin
You import the plugin once. After that you only need to run it (step 4).
1. Get the plugin files. Run this in a terminal:
npx -y @maxsbond/figma-bridge setupIt copies the plugin to Documents/Figma Bridge Plugin and opens that folder. Run it
again after updating to get the new plugin version.
2. Import the plugin. In Figma Desktop open any design file, click the Figma logo in the top-left corner and go to Plugins → Development → Import plugin from manifest… (right-clicking the canvas gets you the same Plugins menu).

3. Pick manifest.json in the Figma Bridge Plugin folder and click Open.
"Figma Bridge" now shows up under Plugins → Development.

4. Run the plugin whenever you want the agent to work in Figma: open the file and pick Plugins → Development → Figma Bridge.

5. Check the connection. The small plugin window says connected to MCP server once an agent with this MCP is running (see the next sections). If the agent isn't running yet, it says "disconnected — retrying…" and connects by itself when the agent starts. Keep the window open while you work, since closing it stops the bridge.

From source
If you'd rather run a checkout: clone the repo, run npm install, import
plugin/manifest.json from it, and in the configs below use node with
/absolute/path/to/figma-bridge/server.js instead of npx -y @maxsbond/figma-bridge.
Use with Claude
Claude Code
claude mcp add --scope user figma-bridge -- npx -y @maxsbond/figma-bridgeCheck it with claude mcp list, or /mcp inside a session. Exports go to
./figma-exports/ in the directory you started claude from.
Or install it as a plugin, which adds the MCP server and the skill in one go. Inside a Claude Code session:
/plugin marketplace add MaxsBond/figma-bridge
/plugin install figma-bridge@figma-bridgeClaude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"figma-bridge": {
"command": "npx",
"args": ["-y", "@maxsbond/figma-bridge"],
"env": {
"FIGMA_BRIDGE_OUT_DIR": "/absolute/path/to/figma-exports"
}
}
}
}Restart Claude Desktop. Set FIGMA_BRIDGE_OUT_DIR here because a desktop app doesn't
start the server in a folder you'd want exports in.
Use with Codex
Works for the Codex CLI, the Codex IDE extension and the ChatGPT desktop app. They all
read ~/.codex/config.toml.
codex mcp add figma-bridge -- npx -y @maxsbond/figma-bridgeor add it by hand:
[mcp_servers.figma-bridge]
command = "npx"
args = ["-y", "@maxsbond/figma-bridge"]
# Codex's default per-tool timeout is 60 s; big exports and scripts can take longer.
tool_timeout_sec = 180
# optional
# [mcp_servers.figma-bridge.env]
# FIGMA_BRIDGE_OUT_DIR = "/absolute/path/to/figma-exports"Check it with codex mcp list, or /mcp inside the Codex TUI.
Use with GitHub Copilot
VS Code (Copilot Chat, agent mode)
The Install in VS Code link above adds the server to your user settings. To add it
to one project instead, create .vscode/mcp.json:
{
"servers": {
"figma-bridge": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@maxsbond/figma-bridge"],
"env": {
"FIGMA_BRIDGE_OUT_DIR": "${workspaceFolder}/figma-exports"
}
}
}
}Click Start above the server entry (or run MCP: List Servers → figma-bridge →
Start), switch Copilot Chat to Agent mode and make sure the figma_* tools are
ticked in the tools picker. MCP tools aren't available in Ask/Edit mode. On Copilot
Business/Enterprise your organization admin has to allow MCP servers.
Copilot CLI
Add it with /mcp add inside copilot, or edit ~/.copilot/mcp-config.json:
{
"mcpServers": {
"figma-bridge": {
"type": "local",
"command": "npx",
"args": ["-y", "@maxsbond/figma-bridge"],
"tools": ["*"]
}
}
}Tools
Tool | What it does |
| Connection check: file name/key, current page, selection |
| Pages of the open file |
| id / name / type / box outline to a given depth, for finding node ids |
| Node JSON to disk: |
| PNG / JPG / SVG / PDF render to disk |
| Original raster images used in image fills |
| Arbitrary Plugin API JavaScript (read and write), |
Node ids can be given as 1:2, 1-2 or a full Figma URL with ?node-id=.
Results over ~15 KB are saved to a file and the tool returns the path instead.
Things to try once it's connected:
"What's selected in Figma? Export it as PNG and JSON."
"Build this React component from Figma node 12:345."
"Rename every layer called
Frame 12…on this page to something meaningful.""Make a dark variant of the selected component set."
Agent skill
skills/figma-bridge/ is a skill that tells the agent
when to reach for the figma_* tools and how to use them well: check the connection
first, find nodes cheaply, export instead of dumping JSON inline, write safe Plugin API
scripts, and build code from a frame. It also walks the agent through setup when the
server or plugin is missing.
Claude Code: the plugin install above includes it. Or copy the folder to
~/.claude/skills/figma-bridge/.Other agents that support skills (Codex, Cursor, Copilot and others): copy the folder to wherever your agent loads skills from.
Zip for skill marketplaces:
npm run pack:skillbuildsdist/figma-bridge-skill.zipwithSKILL.mdat the root.
Configuration
Env var | Default | Meaning |
|
| Where exports are written ( |
|
| WebSocket port. If you change it, change it in |
|
| How long to wait for the plugin to answer one request |
Troubleshooting
"Figma plugin is not connected": run Plugins → Development → Figma Bridge in the file you want to work on. The plugin only sees that one file.
"Port 3055 is already taken": only one server can hold the port, and the plugin talks to whoever does. This happens when two agents run at once (say Claude Code and Codex both have the MCP enabled) or an old server process is still alive. Find it with
lsof -iTCP:3055 -sTCP:LISTENand close that agent or kill the process. The next figma_* call retries the bind, and
the plugin reconnects within ~10 s. To run two agents at the same time, give one of them a
different FIGMA_BRIDGE_PORT and a second copy of the plugin pointing at that port.
Scripts fail with "Cannot unwrap symbol": the result contains figma.mixed
(for example the fontSize of a text node with mixed sizes). Convert it before returning,
e.g. JSON.parse(JSON.stringify(value, (k, v) => typeof v === 'symbol' ? 'MIXED' : v)).
Node not found / page not loaded in scripts: the plugin uses
documentAccess: dynamic-page, so use the async APIs (figma.getNodeByIdAsync,
node.getMainComponentAsync(), page.loadAsync() / figma.loadAllPagesAsync()).
figma.currentPage is whatever page is open in Figma right now, so address nodes by id
rather than relying on it.
Security
The WebSocket listens on 127.0.0.1 only and accepts connections only with
Origin: null (the plugin's sandboxed iframe), so regular web pages can't talk to it.
Keep in mind that figma_run_script runs whatever code the agent sends with full edit
rights on the open file. Figma's undo works for it, but review what your agent is doing
in files that matter.
License
Available Tools
7 toolsfigma_export_imageC
Render a node to PNG/JPG/SVG/PDF and save it to disk.
Inputs: nodeId (required), scale, format, outPath.
figma_export_image_fillsC
Save every raster image used as an IMAGE fill inside a node (original bytes, named by imageHash).
Inputs: nodeId (required), outDir.
figma_export_jsonB
Export the full JSON of a node to a file on disk and return the path plus a short summary. format "rest" = Figma REST API JSON (JSON_REST_V1), "compact" = trimmed tree with resolved style/variable names, "auto" = rest with compact fallback.
Inputs: nodeId (required), format, outPath.
figma_get_treeA
Lightweight outline (id, name, type, box) of a node or the current page, up to a given depth. Use to find node ids.
Inputs: depth, nodeId.
figma_list_pagesB
List pages of the file open in Figma.
Inputs: no named parameters.
figma_run_scriptA
Run arbitrary JavaScript in the plugin with the figma Plugin API global (top-level await, use return). Can read AND modify the open file. Large results are written to a file.
Inputs: code (required).
figma_statusA
Check the plugin connection and return the open file name/key, current page and selection.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Tools are mostly distinct: status/list_pages/get_tree/run_script each serve a clear purpose. The only mild overlap is between get_tree (lightweight outline) and export_json (full export), but the descriptions clearly differentiate lightweight ID-hunting from full serialization, and export_image vs export_image_fills cleanly separate rendering from extracting source bytes.
Consistent figma_ prefix with snake_case verb_noun pattern across nearly all tools (figma_list_pages, figma_get_tree, figma_export_json, figma_export_image, figma_run_script). The only deviation is figma_status, which omits a verb but remains readable and conventional for a health-check tool.
Seven tools is well-scoped for a Figma plugin bridge: connection check, page listing, node discovery, and three export variants plus a scripting escape hatch. No redundancy and nothing feels thin.
Read/inspection coverage is comprehensive (status, pages, tree, JSON, image render, image fills). Modification is covered only indirectly through figma_run_script rather than dedicated create/update/delete tools, which is workable but a minor ergonomic gap for structured mutations.
Maintenance
Related MCP Connectors
The Figma MCP server brings Figma design context directly into your AI workflow.
Serves your design system and coding standards to coding agents, so they stop guessing.
Run accessibility, contrast, and design token audits and file QA issues from your AI coding tool.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- FlicenseCqualityDmaintenanceLocal bridge enabling AI agents to inspect and edit the currently open Figma Desktop file through the Figma Plugin API.292-
- FlicenseNot gradedqualityDmaintenanceEnables AI coding agents to read and write a user's Figma file through the Figma Plugin API, offline and privately, without API tokens or rate limits.-
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect Figma selections, navigate pages, render previews, generate starter code, and submit user-approved canvas edits through a local bridge.3 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read, create, edit, and organize Figma documents directly through a local plugin bridge, without needing a Figma AI subscription.3Apache 2.0