MCP integration between AI agents (Cursor, Claude Code) and Figma for design-to-code
Catalog skill by grab: MCP integration between AI agents (Cursor, Claude Code) and Figma for design-to-code Install into Cursor, Claude, Codex, or VS Code from this page or review the source for Figma MCP.
Ads
git clone https://github.com/grab/cursor-talk-to-figma-mcp
Install guides: Cursor skills, Claude Code skills, Codex skills, or VS Code Copilot skills.
This project implements a Model Context Protocol (MCP) integration between AI agent (Cursor, Claude Code) and Figma, allowing AI agent to communicate with Figma for reading designs and modifying them programmatically.
https://github.com/user-attachments/assets/129a14d2-ed73-470f-9a4c-2240b2a4885c
src/talk_to_figma_mcp/ - TypeScript MCP server for Figma integrationsrc/cursor_mcp_plugin/ - Figma plugin for communicating with Cursorsrc/socket.ts - WebSocket server that facilitates communication between the MCP server and Figma plugincurl -fsSL https://bun.sh/install | bash
bun setup
bun socket
Bulk text content replacement
Thanks to @dusskapark for contributing the bulk text replacement feature. Here is the demo video.
Instance Override Propagation Another contribution from @dusskapark Propagate component instance overrides from a source instance to multiple target instances with a single command. This feature dramatically reduces repetitive design work when working with component instances that need similar customizations. Check out our demo video.
Add the server to your Cursor MCP configuration in ~/.cursor/mcp.json:
{
"mcpServers": {
"TalkToFigma": {
"command": "bunx",
"args": ["cursor-talk-to-figma-mcp@latest"]
}
}
}
Start the WebSocket server:
bun socket
src/cursor_mcp_plugin/manifest.json filepowershell -c "irm bun.sh/install.ps1|iex"
0.0.0.0 in src/socket.ts// uncomment this to allow connections in windows wsl
hostname: "0.0.0.0",
bun socket
join_channelTo develop, update your mcp config to direct to your local directory.
{
"mcpServers": {
"TalkToFigma": {
"command": "bun",
"args": ["/path-to-repo/src/talk_to_figma_mcp/server.ts"]
}
}
}
The MCP server provides the following tools for interacting with Figma:
get_document_info - Get information about the current Figma documentget_selection - Get information about the current selectionread_my_design - Get detailed node information about the current selection without parametersget_node_info - Get detailed information about a specific nodeget_nodes_info - Get detailed information about multiple nodes by providing an array of node IDsset_focus - Set focus on a specific node by selecting it and scrolling viewport to itset_selections - Set selection to multiple nodes and scroll viewport to show themget_annotations - Get all annotations in the current document or specific nodeset_annotation - Create or update an annotation with markdown supportset_multiple_annotations - Batch create/update multiple annotations efficientlyscan_nodes_by_types - Scan for nodes with specific types (useful for finding annotation targets)get_reactions - Get all prototype reactions from nodes with visual highlight animationset_default_connector - Set a copied FigJam connector as the default connector style for creating connections (must be set before creating connections)create_connections - Create FigJam connector lines between nodes, based on prototype flows or custom mappingcreate_rectangle - Create a new rectangle with position, size, and optional namecreate_frame - Create a new frame with position, size, and optional namecreate_section - Create a section to group related content on the canvascreate_text - Create a new text node with customizable font propertiesscan_text_nodes - Scan text nodes with intelligent chunking for large designsset_text_content - Set the text content of a single text nodeset_multiple_text_contents - Batch update multiple text nodes efficientlyset_layout_mode - Set the layout mode and wrap behavior of a frame (NONE, HORIZONTAL, VERTICAL)set_padding - Set padding values for an auto-layout frame (top, right, bottom, left)set_axis_align - Set primary and counter axis alignment for auto-layout framesset_layout_sizing - Set horizontal and vertical sizing modes for auto-layout frames (FIXED, HUG, FILL)set_item_spacing - Set distance between children in an auto-layout frameset_fill_color - Set the fill color of a node (RGBA)set_stroke_color - Set the stroke color and weight of a nodeset_corner_radius - Set the corner radius of a node with optional per-corner controlset_image_fill - Fill a node with an image from a local file path, URL, or base64 data (FILL, FIT, CROP, or TILE)move_node - Move a node to a new positionresize_node - Resize a node with new dimensionsdelete_node - Delete a nodedelete_multiple_nodes - Delete multiple nodes at once efficientlyclone_node - Create a copy of an existing node with optional position offsetrename_node - Rename a nodeset_parent - Move a node into a new parent (section, frame or group), preserving its absolute position by defaultget_styles - Get information about local stylesget_local_components - Get information about local componentscreate_component_instance - Create an instance of a componentget_instance_overrides - Extract override properties from a selected component instanceset_instance_overrides - Apply extracted overrides to target instancesexport_node_as_image - Export a node as an image (PNG, JPG, SVG, or PDF) - limited support on image currently returning base64 as textjoin_channel - Join a specific channel to communicate with FigmaThe MCP server includes several helper prompts to guide you through complex design tasks:
design_strategy - Best practices for working with Figma designsread_design_strategy - Best practices for reading Figma designstext_replacement_strategy - Systematic approach for replacing text in Figma designsannotation_conversion_strategy - Strategy for converting manual annotations to Figma's native annotationsswap_overrides_instances - Strategy for transferring overrides between component instances in Figmareaction_to_connector_strategy - Strategy for converting Figma prototype reactions to connector lines using the output of 'get_reactions', and guiding the use 'create_connections' in sequenceNavigate to the Figma plugin directory:
cd src/cursor_mcp_plugin
Edit code.js and ui.html
When working with the Figma MCP:
get_document_info firstget_selection before modificationscreate_frame for containerscreate_rectangle for basic shapescreate_text for text elementsget_node_infoscan_text_nodesscan_nodes_by_types to find UI elements that annotations refer toget_annotationsset_multiple_annotations in batchesget_reactions to extract prototype flows,set_default_connector,create_connections for clear visual flow mapping.MIT