Skip to main content
Glama
Cursor Talk to Figma MCP

Cursor Talk to Figma MCP

by ysocrius

Cursor Talk to Figma MCP

Note: This repository was created solely to make the MCP integration work via the npx command instead of bunx for easier compatibility and setup.

A Model Context Protocol (MCP) integration that allows Cursor AI to communicate with Figma for reading and modifying designs programmatically.


Prerequisite:

You need Node.js (which includes npx) installed on your system. Download and install it from the official Node.js website. After installation, make sure the installation path for Node.js and npm is added to your system's environment PATH variable so you can run node, npm, and npx from any terminal window.

Default installation paths:

  • Windows: C:\Program Files\nodejs\

  • macOS/Linux: /usr/local/bin/ (or wherever your package manager installs global binaries)

You can check your versions with:

node -v
npx -v

Screenshots:

  • Figma Plugin Localhost Enabled

    Figma plugin with 'Use localhost' enabled

  • Running node_socket_server.mjs in Terminal

    Running MCP via npx in terminal

  • MCP Running via npx in cursor

    MCP server running via npx

  • MCP via cmd and npx in cursor

    MCP server running via cmd and npx on Windows


Installation via NPX

Follow these steps to install and set up the Cursor Talk to Figma MCP:

1. Start the WebSocket Server

The WebSocket server facilitates communication between Cursor and Figma.

  1. Download the node_socket_server.mjs file to your computer

  2. Open a terminal/command prompt and navigate to the directory containing the file

  3. Start the server with Node.js:

node node_socket_server.mjs

Alternatively, create a batch file (Windows) or shell script (Mac/Linux) for easy startup.

2. Configure Cursor MCP Server

  1. In Cursor, navigate to Settings > MCPServers

  2. Add a new MCP server configuration:

{
  "mcpServers": {
    "TalkToFigma": {
      "command": "npx",
      "args": [
        "cursor-talk-to-figma-mcp@latest"
      ]
    }
  }
}

Tip: You can also run this MCP using cmd for compatibility on Windows systems. Here is an example mcpServers configuration for Cursor:

{
  "mcpServers": {
    "TalkToFigma-mcp": {
      "command": "cmd",
      "args": [
        "bash",
        "-c",
        "cmd /c npx -y cursor-talk-to-figma-mcp@latest"
      ]
    }
  }
}

This allows you to invoke the MCP server through cmd using npx, which is especially useful if you encounter compatibility issues with other shells or environments on Windows.

3. Install the Figma Plugin

Option 1: Install from Figma Community

  1. Visit the Cursor Talk to Figma MCP Plugin on Figma Community

  2. Click "Install" to add it to your Figma plugins

Option 2: Install Locally

  1. In Figma, go to Plugins > Development > New Plugin

  2. Choose "Link existing plugin"

  3. Select the manifest.json file from the src/cursor_mcp_plugin directory

  4. The plugin will now appear in your Figma development plugins

4. Connect Cursor to Figma

  1. Open Figma and run the Cursor Talk To Figma MCP Plugin

  2. In the plugin panel, ensure "Use localhost" is enabled on 3055 port

  3. Note the channel name shown in the green connected status message (e.g., "959ykpvn")

  4. In Cursor, join the channel by typing:

mcp_TalkToFigma-mcp_join_channel with channel: "[CHANNEL_NAME]"

Replace [CHANNEL_NAME] with the channel name from the Figma plugin.

Related MCP server: Cursor Talk to Figma MCP

Usage

After connecting, you can use any of the available MCP commands in Cursor to interact with your Figma design. Here are some examples:

mcp_TalkToFigma-mcp_get_document_info

Gets information about the current Figma document

mcp_TalkToFigma-mcp_get_selection

Gets information about the currently selected elements

mcp_TalkToFigma-mcp_create_rectangle with x: 100, y: 100, width: 200, height: 100

Creates a new rectangle at the specified position and size

mcp_TalkToFigma-mcp_create_text with x: 100, y: 100, text: "Hello World"

Creates a new text element with the specified text

Available Commands

The MCP integration provides a wide range of commands for:

  • Reading document and selection information

  • Creating and modifying design elements

  • Working with text, colors, and styles

  • Managing auto-layout properties

  • Handling component instances and overrides

  • Creating and managing annotations

  • Exporting designs as images

For a complete list of available commands and their parameters, refer to the full documentation.

Troubleshooting

  • If you see "Must join a channel" errors, make sure you've joined the correct channel from the Figma plugin

  • If the WebSocket server disconnects, restart it and reconnect the plugin

  • If Cursor can't find the MCP server, verify your MCPServers configuration

  • Ensure that port 3055 is available for the WebSocket server

License

MIT License


Credits

All credits go to sonnylazuardi/cursor-talk-to-figma-mcp, as this project was cloned from their repository: https://github.com/sonnylazuardi/cursor-talk-to-figma-mcp.git

This fork was made solely to enable MCP usage via npx instead of bunx.

This allows you to invoke the MCP server through cmd using npx, which is especially useful if you encounter compatibility issues with other shells or environments on Windows.

Available Tools

38 tools
clone_nodeB

Clone an existing node in Figma

Inputs: nodeId (required), x, y.

create_component_instanceC

Create an instance of a component in Figma

Inputs: x (required), y (required), componentKey (required).

create_connectionsA

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_rectangleB

Create a new rectangle in Figma

Inputs: x (required), y (required), width (required), height (required), +2 more.

create_textB

Create a new text element in Figma

Inputs: x (required), y (required), text (required), name, +4 more.

delete_multiple_nodesA

Delete multiple nodes from Figma at once

Inputs: nodeIds (required).

delete_nodeC

Delete a node from Figma

Inputs: nodeId (required).

export_node_as_imageB

Export a node as an image from Figma

Inputs: nodeId (required), scale, format.

get_annotationsA

Get all annotations in the current document or specific node

Inputs: nodeId, includeCategories.

get_document_infoB

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_infoA

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_channelB

Join a specific channel to communicate with Figma

Inputs: channel.

move_nodeA

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_typesA

Scan for child nodes with specific types in the selected Figma node

Inputs: types (required), nodeId (required).

scan_text_nodesB

Scan all text nodes in the selected Figma node

Inputs: nodeId (required).

set_annotationC

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_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 (required).

set_layout_modeB

Set the layout mode and wrap behavior of a frame in Figma

Inputs: nodeId (required), layoutMode (required), layoutWrap.

set_layout_sizingB

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_contentsC

Set multiple text contents parallelly in a node

Inputs: text (required), nodeId (required).

set_paddingA

Set padding values for an auto-layout frame in Figma

Inputs: nodeId (required), paddingTop, paddingLeft, paddingRight, +1 more.

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

    B3.2/5.0

    Scored across 38 tools

    Disambiguation4/5

    Most tools target distinct resources and actions (e.g., set_padding vs. set_item_spacing). However, get_selection and read_my_design both describe getting selection info with subtle differences, and get_node_info vs. get_nodes_info could confuse agents.

    Naming Consistency4/5

    The vast majority follow a consistent verb_noun snake_case pattern (get_, set_, create_, delete_, etc.). Minor deviations like read_my_design and the multiple batch variants (set_multiple_*) break the pattern slightly.

    Tool Count2/5

    With 38 tools, this server is well beyond the typical 3-15 tool range. While Figma is a complex domain, this many tools feels heavy and could overwhelm agents, making selection harder.

    Completeness4/5

    The tool set covers a broad range of Figma operations: node CRUD, text, frames, components, styles, layout, annotations, exports, and prototyping reactions/connections. Some niche operations like style creation or component updates are absent, but core workflows are well covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers