Custom Figma MCP
Provides tools for inspecting and editing Figma documents via the Figma Plugin API, including creating frames, text, rectangles, components, auto-layout, variables, styles, exports, and batch operations. Allows AI agents to interact with the currently open Figma Desktop file.
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., "@Custom Figma MCP create a frame named 'Hero' with width 1200 and height 600"
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.
Custom Figma MCP
Use Codex or Claude Code to inspect and edit the Figma file that is open in Figma Desktop.
This is a local tool. It does not use the official Figma MCP, Figma OAuth, Figma API keys, file keys, or Figma web URLs for normal editing.
Install First
1. Install Requirements
Figma Desktop
Node.js 22.5 or newer
pnpm 10.25 or newer
If pnpm is missing, ./run.sh will try to enable it with Corepack.
2. Start This Project
Open Terminal:
cd /path/to/figma-mcp
./run.shKeep this Terminal window open while you use Figma MCP.
3. Add The Figma Plugin Once
Open Figma Desktop.
Go to
Plugins -> Development -> Import plugin from manifest....Select
figma-plugin/manifest.jsonfrom this project.Run
Plugins -> Development -> Custom Figma MCP Bridge.
The plugin should show Connected.
4. Connect Your AI Tool
For Codex:
codex mcp add custom-figma-mcp -- /bin/zsh -lc 'cd /path/to/figma-mcp && node mcp-server/dist/index.js'For Claude Code:
claude mcp add --transport stdio custom-figma-mcp -- /bin/zsh -lc 'cd /path/to/figma-mcp && node mcp-server/dist/index.js'Use the real full path to this folder.
After adding it, restart Codex or Claude Code.
Related MCP server: finish-line
Daily Use
Open the Figma file in Figma Desktop.
In Terminal, run:
cd /path/to/figma-mcp
./run.shIn Figma Desktop, run
Plugins -> Development -> Custom Figma MCP Bridge.Start Codex or Claude Code.
Ask it to inspect or edit the open Figma file.
Check That It Works
Run:
curl http://localhost:3333/healthGood result:
{
"ok": true,
"pluginConnected": true
}If pluginConnected is false, open Figma Desktop, open your file, and run Plugins -> Development -> Custom Figma MCP Bridge.
What This Does
This project creates a local bridge:
Codex / Claude Code
-> local MCP server
-> local WebSocket
-> Figma Desktop plugin
-> your open Figma fileThe AI tool can read and edit the file that is currently open in Figma Desktop.
It can create and update frames, text, rectangles, components, auto-layout frames, styles, variables, and other supported Figma Plugin API objects.
Common Problems
The Plugin Says Reconnecting
Make sure
./run.shis still running.Click
Reconnectin the plugin.If it still fails, close and run the plugin again from
Plugins -> Development.
The Health Check Says pluginConnected false
The local server is running, but Figma Desktop is not connected.
Open Figma Desktop, open the target file, and run Custom Figma MCP Bridge.
Codex Or Claude Does Not Show The Tools
Restart Codex or Claude Code after adding the MCP server.
In Codex or Claude Code, run /mcp and look for custom-figma-mcp.
More Help
Codex setup: docs/codex-setup.md
Claude Code setup: docs/claude-code-setup.md
Figma plugin setup: docs/figma-setup.md
Architecture details: docs/architecture.md
Developer Commands
pnpm install
pnpm build
pnpm typecheck
pnpm doctor
pnpm test:integration
./run.sh --checkAvailable Tools
29 toolsfigma.batch_operationsBatch operationsB
Run multiple plugin commands in sequence with undo-backed transactional rollback by default.
Inputs: operations (required), transactional, continueOnError, rollbackOnError.
figma.call_apiCall raw Figma Plugin APIC
Dynamically call any Plugin API method on figma, a node, page, style, variable, or API namespace.
Inputs: method (required), target (required), args, nodeId, +6 more.
figma.create_autolayoutCreate auto-layoutC
Create a Figma auto-layout frame.
Inputs: x, y, name, index, +6 more.
figma.create_componentCreate componentC
Create a native Figma component.
Inputs: x, y, name, index, +6 more.
figma.create_frameCreate frameC
Create a native Figma frame.
Inputs: x, y, name, index, +6 more.
figma.create_nodeCreate via any figma.create* APIB
Call any current or future figma.create* method discovered from official typings, then optionally set properties and reparent the result.
Inputs: createMethod (required), args, index, pageId, +2 more.
figma.create_rectangleCreate rectangleC
Create a native Figma rectangle.
Inputs: x, y, name, index, +5 more.
figma.create_textCreate textB
Create editable native Figma text, loading the requested font first.
Inputs: x, y, name, index, +9 more.
figma.delete_nodeDelete nodeC
Delete a node from the open Figma file.
Inputs: nodeId (required), hardDelete.
figma.duplicate_nodeDuplicate nodeC
Duplicate a node by cloning it.
Inputs: nodeId (required), offsetX, offsetY, parentId.
figma.export_nodeExport nodeC
Export a node as PNG, JPG, SVG, or PDF and return base64 content.
Inputs: nodeId (required), scale, format.
figma.find_nodesFind nodesC
Search nodes by name, type, CSS-like query, page, or document scope.
Inputs: type, query, pageId, allPages, +3 more.
figma.get_api_schemaGet generated Figma API schemaC
Return the generated contract parsed from official Figma Plugin API typings and REST OpenAPI sources.
Inputs: limit, category, memberName, objectName, +2 more.
figma.get_current_pageGet current pageA
Return serialized data for the current Figma page.
Inputs: no named parameters.
figma.get_documentGet Figma documentA
Return serialized pages and top-level nodes from the open Figma document.
Inputs: no named parameters.
figma.get_nodeGet nodeC
Return serialized data for a specific node.
Inputs: nodeId (required).
figma.get_propertyGet raw Figma Plugin API propertyC
Read any serializable Plugin API property from figma, a node, page, style, variable, or API namespace.
Inputs: target (required), property (required), nodeId, pageId, +5 more.
figma.get_selectionGet selectionA
Return serialized data for the current Figma selection.
Inputs: no named parameters.
figma.list_stylesList stylesA
List local text, paint, effect, and grid styles.
Inputs: no named parameters.
figma.list_variablesList variablesA
List local variable collections and variables.
Inputs: no named parameters.
figma.move_nodeMove nodeC
Move a node within the canvas or reparent it.
Inputs: nodeId (required), x, y, index, +1 more.
figma.poll_eventsPoll Figma eventsC
Poll queued Figma Plugin API events captured by subscribe_event.
Inputs: limit, eventType, sinceSequence.
figma.resize_nodeResize nodeD
Resize a node.
Inputs: width (required), height (required), nodeId (required).
figma.rest_requestCall raw Figma REST APIC
Call any official Figma REST API operation by operationId or raw method/path using stored OAuth tokens.
Inputs: body, path, query, method, +4 more.
figma.set_propertySet raw Figma Plugin API propertyC
Set any writable Plugin API property on figma, a node, page, style, variable, or API namespace.
Inputs: value (required), target (required), property (required), nodeId, +6 more.
figma.subscribe_eventSubscribe to Figma eventC
Subscribe to a Figma Plugin API event on figma or another event-capable API target and queue events for polling.
Inputs: eventType (required), once, nodeId, pageId, +9 more.
figma.unsubscribe_eventUnsubscribe from Figma eventA
Remove a previously registered Figma Plugin API event subscription by subscription id or event type.
Inputs: eventType, subscriptionId.
figma.update_nodeUpdate nodeC
Update node properties, styles, layout, bounds, or text.
Inputs: nodeId (required), name, style, bounds, +5 more.
figma.update_variableUpdate variableC
Update a local or imported Figma variable mode value.
Inputs: value (required), modeId (required), variableId, variableKey.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Most tools target distinct operations, but `figma.create_node` overlaps with specific create tools, and `figma.set_property` overlaps with `figma.update_node`. Descriptions help clarify, but some ambiguity remains.
All tools follow a consistent `figma.verb_noun` pattern (e.g., `create_frame`, `get_node`), with no mixing of conventions.
29 tools cover a broad range of Figma operations, but some tools could be merged (e.g., `call_api` and `rest_request`). Still, it's reasonably scoped for a comprehensive MCP server.
Covers node CRUD, styles/variables listing, events, and API access, but missing create for styles/variables and page management. Notable gaps for a full design tool surface.
Maintenance
Related MCP Connectors
The Figma MCP server brings Figma design context directly into your AI workflow.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Serves your design system and coding standards to coding agents, so they stop guessing.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- FlicenseBqualityCmaintenanceLocal MCP server connecting AI clients to the Figma desktop app for inspecting and editing Figma documents via the Plugin API.161-
- 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
- AlicenseAqualityBmaintenanceEnables AI coding agents to read and edit the file currently open in Figma Desktop through a local development plugin, supporting node inspection, JSON/image exports, and arbitrary Plugin API scripts without REST API rate limits.711 npmMIT