Skip to content
Back to search

claude-talk-to-figma-mcp

A Model Context Protocol (MCP) that allows Claude Desktop and other AI tools (Claude Code, Cursor, Antigravity, etc.) to read, analyze, and modify Figma designs

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/arinspunk--claude-talk-to-figma-mcp/badge.svg)](/listings/arinspunk--claude-talk-to-figma-mcp)

HTML

<a href="/listings/arinspunk--claude-talk-to-figma-mcp"><img src="/api/listings/arinspunk--claude-talk-to-figma-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Setup:** 5 minutes | **First automation:** 2 minutes

Requirements

- [Node.js](https://nodejs.org/en/download) installed - [Figma Desktop](https://www.figma.com/downloads/) - AI client: - [Claude Desktop](https://claude.ai/download) - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) - [Cursor](https://cursor.com/downloads) - [Antigravity](https://antigravity.google/download) - [Windsurf](https://windsurf.com/download) - [VS Code](https://code.visualstudio.com/) + [GitHub Copilot](https://github.com/features/copilot) - [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) - [Roo Code](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline)

Step 1: Install and start the websocket

*Enables the Agent to send commands to Figma.*

Open your terminal, navigate to the folder where you want to install the tool, and run:

npx claude-talk-to-figma-mcp

> **πŸ’‘ Tip**: This command is an "all-in-one" (clones, installs, and starts). In subsequent sessions, if you're already inside the project folder `your-project/claude-talk-to-figma-mcp`, you can simply run `bun run socket`.

Step 2: Install the plugin in Figma

*Enables Figma to receive commands from the agent and return responses.*

In Figma Desktop go to Menu β†’ Plugins β†’ Development β†’ Import plugin from manifest β†’ inside the folder where you installed the MCP, select `src/claude_mcp_plugin/manifest.json`

Step 3: Configure your Agentic Tool

*Enables the agent to use the MCP's read and modify tools.*

Claude Desktop

Download [claude-talk-to-figma-mcp.dxt](https://github.com/arinspunk/claude-talk-to-figma-mcp/releases) (from Assets section of the latest release) and double-click. Claude configures itself automatically.

Cursor

1. Open **Cursor Settings β†’ Tools & Integrations** 2. Click **"New MCP Server"** to open the `mcp.json` file 3. Add this configuration:

  {
    "mcpServers": {
      "ClaudeTalkToFigma": {
        "command": "npx",
        "args": ["-p", "claude-talk-to-figma-mcp@latest", "claude-talk-to-figma-mcp-server"]
      }
    }
  }

4. Save the file and restart Cursor

Other Agentic Tools

For other tools (Claude Code, Windsurf, VS Code + GitHub Copilot, Cline, Roo Code), you can follow the instructions in the ["Configure your Agentic Tool" chapter of the detailed installation guide](INSTALLATION.md#3-configure-your-agentic-tool).

Step 4: Start working

1. Open the plugin in Figma 2. Copy the channel ID (bold code inside the green box) 3. Type in the chat: `Connect to Figma, channel {your-ID}`

βœ… Ready to design with AI!

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

readme.md Β· README Β· 192 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![Claude Talk to Figma collage](images/claude-talk-to-figma.png)
  2. # <del>Claude</del> <ins>AI Agents</ins> Talk to Figma MCP
  3. Enable your AI agents to read, analyze, and modify Figma designs.
  4. Works with your favorite agentic tools:
  5. - [Claude Desktop](https://claude.ai/)
  6. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
  7. - [Cursor](https://cursor.com/)
  8. - [Antigravity](https://antigravity.google/)
  9. - [Windsurf](https://windsurf.com/)
  10. - [VS Code](https://code.visualstudio.com/) + [GitHub Copilot](https://github.com/features/copilot)
  11. - [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)
  12. - [Roo Code](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline)
  13. ## πŸ‘©πŸ½β€πŸ’» Who it's for
  14. ### UX/UI Teams
  15. Automate repetitive design tasks and maintain brand consistency without manual effort:
  16. - **Automated accessibility audits** - Detect and fix contrast issues in seconds
  17. - **Bulk style updates** - Change colors, typography, or spacing across the entire document with a single command
  18. - **Visual hierarchy analysis** - Get instant feedback on your design structure
  19. ### Developers
  20. Generate production-ready code directly from designs:
  21. - **React/Vue/SwiftUI components** - From design to code in one step
  22. - **Code with design tokens** - Keep design and development in sync
  23. - **Reduce handoff friction** - Fewer back-and-forth iterations with the design team
  24. > **Key advantage**: Unlike [Figma's official MCP](https://www.figma.com/mcp-catalog/) which requires a Dev Mode license, this MCP **works with any Figma account** (even free ones).
  25. ## πŸ’‘ Real-world use cases
  26. **Accessibility:**
  27. > "Find all text with contrast ratio <4.5:1 and suggest colors that meet WCAG AA"
  28. **Rebranding:**
  29. > "Change #FF6B6B to #E63946 in all primary buttons throughout the document"
  30. **Design analysis:**
  31. > "Analyze the visual hierarchy of this screen and suggest improvements based on design principles"
  32. **Developer handoff:**
  33. > "Generate the React component for 'CardProduct' including PropTypes and styles in CSS modules"
  34. ## ⚑️ Quick installation
  35. **Setup:** 5 minutes | **First automation:** 2 minutes
  36. ### Requirements
  37. - [Node.js](https://nodejs.org/en/download) installed
  38. - [Figma Desktop](https://www.figma.com/downloads/)
  39. - AI client:
  40. - [Claude Desktop](https://claude.ai/download)
  41. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
  42. - [Cursor](https://cursor.com/downloads)
  43. - [Antigravity](https://antigravity.google/download)
  44. - [Windsurf](https://windsurf.com/download)
  45. - [VS Code](https://code.visualstudio.com/) + [GitHub Copilot](https://github.com/features/copilot)
  46. - [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)
  47. - [Roo Code](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline)
  48. ### Step 1: Install and start the websocket
  49. *Enables the Agent to send commands to Figma.*
  50. Open your terminal, navigate to the folder where you want to install the tool, and run:
  51. ```bash
  52. npx claude-talk-to-figma-mcp
  53. ```
  54. > **πŸ’‘ Tip**: This command is an "all-in-one" (clones, installs, and starts). In subsequent sessions, if you're already inside the project folder `your-project/claude-talk-to-figma-mcp`, you can simply run `bun run socket`.
  55. ### Step 2: Install the plugin in Figma
  56. *Enables Figma to receive commands from the agent and return responses.*
  57. In Figma Desktop go to Menu β†’ Plugins β†’ Development β†’ Import plugin from manifest β†’ inside the folder where you installed the MCP, select `src/claude_mcp_plugin/manifest.json`
  58. ### Step 3: Configure your Agentic Tool
  59. *Enables the agent to use the MCP's read and modify tools.*
  60. #### Claude Desktop
  61. Download [claude-talk-to-figma-mcp.dxt](https://github.com/arinspunk/claude-talk-to-figma-mcp/releases) (from Assets section of the latest release) and double-click. Claude configures itself automatically.
  62. #### Cursor
  63. 1. Open **Cursor Settings β†’ Tools & Integrations**
  64. 2. Click **"New MCP Server"** to open the `mcp.json` file
  65. 3. Add this configuration:
  66. ```json
  67. {
  68. "mcpServers": {
  69. "ClaudeTalkToFigma": {
  70. "command": "npx",
  71. "args": ["-p", "claude-talk-to-figma-mcp@latest", "claude-talk-to-figma-mcp-server"]
  72. }
  73. }
  74. }
  75. ```
  76. 4. Save the file and restart Cursor
  77. #### Other Agentic Tools
  78. For other tools (Claude Code, Windsurf, VS Code + GitHub Copilot, Cline, Roo Code), you can follow the instructions in the ["Configure your Agentic Tool" chapter of the detailed installation guide](INSTALLATION.md#3-configure-your-agentic-tool).
  79. ### Step 4: Start working
  80. 1. Open the plugin in Figma
  81. 2. Copy the channel ID (bold code inside the green box)
  82. 3. Type in the chat: `Connect to Figma, channel {your-ID}`
  83. βœ… Ready to design with AI!
  84. ## Subsequent work sessions
  85. To use the MCP again in day-to-day work, you don't need to repeat the entire process:
  86. 1. **Start the socket**: In the terminal, enter the project folder `your-project/claude-talk-to-figma-mcp` and run `bun run socket` (or `npm run socket`).
  87. 2. **Open the plugin in Figma**: You'll find it in your recent plugins list.
  88. 3. **Connect the AI**: Copy the channel ID and tell your agent: `Connect to Figma, channel {your-ID}`.
  89. ## πŸ€– Multi-Agent & Parallel execution
  90. This MCP server supports **safe parallel execution** out of the box, allowing multiple AI agents (e.g. Claude Code's sub-agents or team swarms) to work simultaneously on your Figma file without locking up the plugin. A built-in command queue processes requests sequentially on the server side, preventing the Figma API from timing out.
  91. > **Note**: Because multiple agents can modify the document simultaneously, relying on implicit page context is unsafe. As a result, stateful commands like `set_current_page` are **blocked**. All agents must explicitly provide the intended `parentId` parameter when executing any creation or structural modification command (e.g., `create_frame`, `create_text`).
  92. *(Special thanks to [@mmabas77](https://github.com/mmabas77) for architecting and contributing this feature!)*
  93. ## 🐳 Alternative: Using Docker
  94. If you prefer Docker or need to run the WebSocket server in a team environment, see the [Docker installation guide](INSTALLATION.md#alternative-using-docker) in the detailed installation documentation.
  95. ## πŸ› οΈ Capabilities
  96. **Design analysis**
  97. - Get document information, current selection, styles
  98. - Scan text, audit components, export assets
  99. **Element creation**
  100. - Shapes, text, frames with full style control
  101. - Clone, group, organize elements
  102. **Modification**
  103. - Colors, borders, corners, shadows
  104. - Auto-layout, advanced typography
  105. - Local components and team library components
  106. See [complete command list](COMMANDS.md).
  107. ## πŸ“š Documentation
  108. - [Detailed installation](INSTALLATION.md) β€” Manual setup, Cursor, Windsurf and other IDEs
  109. - [Available commands](COMMANDS.md) β€” Complete tool reference
  110. - [Troubleshooting](TROUBLESHOOTING.md) β€” Common errors and how to fix them
  111. - [Contributing](CONTRIBUTING.md) β€” Architecture, testing, contribution guide
  112. - [Changelog](CHANGELOG.md) β€” Version history
  113. ## πŸ™ Credits
  114. Based on [cursor-talk-to-figma-mcp](https://github.com/sonnylazuardi/cursor-talk-to-figma-mcp) by Sonny Lazuardi. Adapted for Claude Desktop and extended with new tools by [XΓΊlio ZΓ©](https://github.com/arinspunk).
  115. If you want to know about all project contributions, you can visit the ["Contributors" chapter of the contribution guide](CONTRIBUTING.md#contributors).
  116. [MIT License](LICENSE)
  117. ---
  118. ## πŸ“Š Project status
  119. βœ… **Stable production** - Tool ready for daily use in design and development teams
  120. πŸš€ **Under active development:**
  121. - Complete support for Figma Variables
  122. - Enhanced export to Tailwind CSS/SwiftUI
  123. ### Need something specific?
  124. **[Propose new ones on GitHub Issues](https://github.com/arinspunk/claude-talk-to-figma-mcp/issues)**
  125. Your feedback and contributions keep the project alive. ❀️

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.