figma-tunnel-mcp
The figma-tunnel-mcp server lets AI agents and MCP clients (e.g., Claude, Cursor) programmatically read, modify, and export Figma designs via a local WebSocket bridge, optionally exposed through a Cloudflare tunnel.
Document & Selection
get_document_info,get_selection,read_my_design,get_node_info,get_nodes_info– Read document and node detailsset_focus,set_selections– Control viewport focus and selection
Creating Elements
create_rectangle,create_frame,create_text– Draw rectangles, frames, and text nodes with full styling options
Modifying Nodes
set_fill_color,set_stroke_color,set_corner_radius– Style nodesmove_node,resize_node,clone_node,delete_node,delete_multiple_nodes– Transform and manage nodes
Text Operations
scan_text_nodes– Find all text nodes within a nodeset_text_content,set_multiple_text_contents– Update text content individually or in batch
Auto Layout & Spacing
set_layout_mode,set_padding,set_axis_align,set_layout_sizing,set_item_spacing– Configure auto-layout properties on frames
Components & Styles
get_styles,get_local_components– List local styles and componentscreate_component_instance,get_instance_overrides,set_instance_overrides– Instantiate components and manage overrides
Annotations
get_annotations,set_annotation,set_multiple_annotations– Read and write annotations (Markdown supported)scan_nodes_by_types– Find nodes by type (useful for annotation targeting)
Prototyping & Connections
get_reactions– Extract prototype flows from nodesset_default_connector,create_connections– Draw FigJam connector lines between nodes
Export
export_node_as_image– Export a node as PNG, JPG, SVG, or PDF (returns base64)
Connection Management
join_channel– Join a named WebSocket channel to establish communication with the Figma plugin
Allows AI agents to control and export from Figma, including reading designs, modifying nodes, text content, styling, layout, creating elements, and bulk text replacement via a WebSocket bridge.
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-tunnel-mcp Export the main frame as a 2x PNG"
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 HTTP API
Share the currently open Figma file with an AI agent through one HTTPS URL. The agent reads llms.txt and uses ordinary GET and POST requests.
AI agent
│ HTTPS API
▼
Local API server (:8765) ← Cloudflare Tunnel
│ local WebSocket
▼
Figma API Plugin ↔ open Figma fileThe WebSocket relay is an internal transport. It is not exposed publicly and is not an interface for agents.
Start on Windows
Requirements: Figma Desktop, Node.js, Bun, and Cloudflared.
In Figma, import
src/plugin/manifest.jsonas a development plugin once.Start everything with one command:
.\start.cmd
The command starts the internal relay, HTTP API, Figma, Cloudflare Tunnel, and the plugin watchdog. It then tries to open the plugin and verifies that the current document answers.
Nothing is installed in Windows Startup. Re-running the command is safe and only repairs missing services.
Related MCP server: Agent to Figma MCP
Plugin controls
After the server is running, normal management happens in the Figma plugin:
API, Figma, and tunnel status;
read-only or read/write access;
copy/open share URL and scoped
llms.txt;start, stop, or replace the Cloudflare quick tunnel;
rotate the secret share URL;
repair the local stack.
Public API
Give the agent only the generated share URL:
https://<host>.trycloudflare.com/s/<secret>The main routes are:
Method | Route | Purpose |
|
| Discover exact URLs and current state |
|
| Complete live API instructions |
|
| Documentation for this share |
|
| Documentation for one route or operation |
|
| Check readiness |
|
| List available Figma operations |
|
| Execute an operation; the body contains its parameters |
|
| OpenAPI 3.1 contract |
Example read request:
POST /v1/shares/{secret}/get_document_info
Content-Type: application/json
{}Write requests also require an Idempotency-Key header. Documentation is hierarchical: service errors link to /llms.txt, share errors link to /v1/shares/{secret}/llms.txt, and known route errors link to that route's own llms.txt.
Security
The random share URL is a bearer capability; anyone holding it gets the configured access.
Public access can be stopped immediately from the plugin.
Rotating the secret invalidates the previous share URL.
Management routes under
/local/control/*accept only loopback plugin requests and return404through Cloudflare.The internal relay binds only to
127.0.0.1.Access mode and tunnel state persist across server repairs.
Project files
File | Purpose |
| Single user-facing start command |
| Public API server and health probe |
| Loopback-only Figma transport |
| Figma development plugin |
| Windows bootstrap, watchdog, tunnel, and Figma launcher |
Available Tools
40 toolsclone_nodeC
Clone an existing node in Figma
Inputs: nodeId (required), x, y.
create_component_instanceA
Create an instance of a component in Figma. For LOCAL components (from get_local_components), use componentId with the id field. For published LIBRARY components, use componentKey with the publishedKey field.
Inputs: x (required), y (required), parentId, componentId, +1 more.
create_connectionsB
Create connections between nodes using the default connector style
Inputs: connections (required).
create_frameC
Create a new frame in Figma
Inputs: x (required), y (required), width (required), height (required), +16 more.
create_rectangleC
Create a new rectangle in Figma
Inputs: x (required), y (required), width (required), height (required), +2 more.
create_textC
Create a new text element in Figma
Inputs: x (required), y (required), text (required), name, +4 more.
delete_multiple_nodesB
Delete multiple nodes from Figma at once
Inputs: nodeIds (required).
delete_nodeC
Delete a node from Figma
Inputs: nodeId (required).
export_node_as_imageC
Export a node as an image from Figma
Inputs: nodeId (required), scale, format.
get_annotationsB
Get all annotations in the current document or specific node
Inputs: nodeId (required), includeCategories.
get_document_infoA
Get detailed information about the current Figma document
Inputs: no named parameters.
get_instance_overridesA
Get all override properties from a selected component instance. These overrides can be applied to other instances, which will swap them to match the source component.
Inputs: nodeId.
get_local_componentsA
Get all local components from the Figma document
Inputs: no named parameters.
get_node_infoB
Get detailed information about a specific node in Figma
Inputs: nodeId (required).
get_nodes_infoC
Get detailed information about multiple nodes in Figma
Inputs: nodeIds (required).
get_reactionsA
Get Figma Prototyping Reactions from multiple nodes. CRITICAL: The output MUST be processed using the 'reaction_to_connector_strategy' prompt IMMEDIATELY to generate parameters for connector lines via the 'create_connections' tool.
Inputs: nodeIds (required).
get_selectionB
Get information about the current selection in Figma
Inputs: no named parameters.
get_stylesA
Get all styles from the current Figma document
Inputs: no named parameters.
join_channelC
Join a specific channel to communicate with Figma
Inputs: channel.
move_nodeC
Move a node to a new position in Figma
Inputs: x (required), y (required), nodeId (required).
read_my_designA
Get detailed information about the current selection in Figma, including all node details
Inputs: no named parameters.
resize_nodeC
Resize a node in Figma
Inputs: width (required), height (required), nodeId (required).
scan_nodes_by_typesC
Scan for child nodes with specific types in the selected Figma node
Inputs: types (required), nodeId (required).
scan_text_nodesC
Scan all text nodes in the selected Figma node
Inputs: nodeId (required).
set_annotationB
Create or update an annotation
Inputs: nodeId (required), labelMarkdown (required), categoryId, properties, +1 more.
set_axis_alignA
Set primary and counter axis alignment for an auto-layout frame in Figma
Inputs: nodeId (required), counterAxisAlignItems, primaryAxisAlignItems.
set_corner_radiusA
Set the corner radius of a node in Figma
Inputs: nodeId (required), radius (required), corners.
set_default_connectorB
Set a copied connector node as the default connector
Inputs: connectorId.
set_fill_colorC
Set the fill color of a node in Figma can be TextNode or FrameNode
Inputs: b (required), g (required), r (required), nodeId (required), +1 more.
set_focusA
Set focus on a specific node in Figma by selecting it and scrolling viewport to it
Inputs: nodeId (required).
set_instance_overridesA
Apply previously copied overrides to selected component instances. Target instances will be swapped to the source component and all copied override properties will be applied.
Inputs: targetNodeIds (required), sourceInstanceId (required).
set_item_spacingA
Set distance between children in an auto-layout frame
Inputs: nodeId (required), itemSpacing, counterAxisSpacing.
set_layout_modeB
Set the layout mode and wrap behavior of a frame in Figma
Inputs: nodeId (required), layoutMode (required), layoutWrap.
set_layout_sizingA
Set horizontal and vertical sizing modes for an auto-layout frame in Figma
Inputs: nodeId (required), layoutSizingVertical, layoutSizingHorizontal.
set_multiple_annotationsC
Set multiple annotations parallelly in a node
Inputs: nodeId (required), annotations (required).
set_multiple_text_contentsB
Set multiple text contents parallelly in a node
Inputs: text (required), nodeId (required).
set_paddingB
Set padding values for an auto-layout frame in Figma
Inputs: nodeId (required), paddingTop, paddingLeft, paddingRight, +1 more.
set_selectionsA
Set selection to multiple nodes in Figma and scroll viewport to show them
Inputs: nodeIds (required).
set_stroke_colorB
Set the stroke color of a node in Figma
Inputs: b (required), g (required), r (required), nodeId (required), +2 more.
set_text_contentA
Set the text content of an existing text node in Figma
Inputs: text (required), nodeId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Most tools have distinct purposes, but there is slight overlap between get_selection and read_my_design, and between set_selections and set_focus. Annotation and text tools are clearly separated by singular/plural variants.
All tools follow a consistent verb_noun pattern using snake_case, e.g., create_frame, delete_node, set_fill_color. No mixed conventions or ambiguous verb choices.
With 40 tools, the server is on the heavy side for a typical MCP server. While Figma is complex, the tool count may overwhelm agents; some property-setting tools could potentially be consolidated.
The tool set covers many common Figma operations (CRUD for nodes, components, styles, annotations, layout properties, and selection management). Missing operations like reordering or grouping nodes are minor gaps.
Maintenance
Related MCP Connectors
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Reach your own computers from any AI app: files, search, commands, approvals and outage alerts.
Related MCP Servers
- -licenseCqualityNot gradedmaintenanceEnables AI agents to interact with Figma in real-time through a WebSocket connection. Supports comprehensive design operations including text manipulation, layouts, components, variables, and export functionality.72207 npm-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents like Claude to interact with Figma designs through 50+ tools for creating, styling, and manipulating design elements, components, and variables via a WebSocket relay and Figma plugin.-
- FlicenseBqualityDmaintenanceEnables AI agents to read and modify Figma designs programmatically through WebSocket communication, supporting document manipulation, styling, text replacement, and component management.425-
- AlicenseBqualityCmaintenanceEnables local AI agents to generate and edit Figma designs via the Plugin API through a WebSocket relay, with no rate limits and all communication remaining local.50MIT