# Talk to Figma MCP — Control Figma from Cursor

> Talk to Figma MCP connects Cursor/Claude Code to Figma via an MCP server plus plugin, enabling read/modify workflows for design automation.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

1. Install Bun:
   ```bash
   curl -fsSL https://bun.sh/install | bash
   ```
2. Run setup and start the socket server:
   ```bash
   bun setup
   bun socket
   ```
3. Verify:
   - Install the Figma plugin and confirm you can run at least 1 MCP tool call that reads design data.

## Intro

Talk to Figma MCP connects Cursor/Claude Code to Figma via an MCP server plus plugin, enabling read/modify workflows for design automation.

- **Best for:** teams automating design updates who want an MCP bridge between AI IDEs and Figma
- **Works with:** Cursor or Claude Code, Figma desktop/web, Bun runtime, and the included plugin
- **Setup time:** 30–75 minutes

## Practical Notes

- Quant: start with 1 bulk text replace task and measure time saved vs manual edits.
- Quant: track failure rate for tool calls (connection, auth, plugin channel) over 10 runs.

## Recommended workflow

1. Keep the socket server running while you work.
2. Use small, reversible actions first (read-only, then text replacement).
3. Add a review step: export a before/after summary (list of nodes changed).

## Safety note

Design automation can create large diffs. Prefer running changes on a copy, and only apply to the main file after review.

### FAQ

**Q: Do I need Cursor specifically?**
A: Cursor is one supported client; the README also mentions Claude Code usage patterns.

**Q: What usually breaks first?**
A: The socket connection and plugin channel setup—start with a simple read-only call.

**Q: Can I run it in teams?**
A: Yes, but standardize config and add a review process for large automated edits.

## Source & Thanks

> Source: https://github.com/grab/cursor-talk-to-figma-mcp
> License: MIT
> GitHub stars: 6,747 · forks: 734

---

<!-- ZH -->

## 快速使用

1. 安装 Bun：
   ```bash
   curl -fsSL https://bun.sh/install | bash
   ```
2. 运行 setup 并启动 socket：
   ```bash
   bun setup
   bun socket
   ```
3. 验证：
   - 安装 Figma 插件，确认至少能执行 1 次 MCP 工具调用并读取到设计数据。

## 简介

Talk to Figma MCP 通过 MCP server + Figma 插件把 Cursor/Claude Code 与 Figma 连接起来，让你用对话驱动读取设计、批量替换文本或修改组件等自动化操作，减少重复的设计改动成本。

- **适合谁：** 希望自动化批量设计改动、让 AI IDE 直连 Figma 的团队
- **可搭配：** Cursor 或 Claude Code、Figma（桌面/网页）、Bun 运行时与配套插件
- **准备时间：** 30–75 分钟

## 实战建议

- 量化建议：先做 1 个批量文本替换任务，对比手工修改节省的时间。
- 量化建议：连续跑 10 次统计工具调用失败率（连接/鉴权/插件通道）。

## 推荐工作流

1. 工作期间保持 socket server 常驻。
2. 先从可逆操作开始（只读 → 再到文本替换）。
3. 增加复核步骤：输出 before/after 摘要（列出被修改的节点）。

## 安全提示

设计自动化很容易产生大改动。优先在副本文件上跑，复核后再合并到主文件。

### FAQ

**一定要用 Cursor 吗？**
答：不一定。它支持 Cursor，也提到 Claude Code 的使用方式。

**最常见的故障点是？**
答：socket 连接与插件通道配置。建议先用只读调用做连通性验证。

**适合团队协作吗？**
答：适合，但需要统一配置并对大规模自动改动做复核流程。

## 来源与感谢

> Source: https://github.com/grab/cursor-talk-to-figma-mcp
> License: MIT
> GitHub stars: 6,747 · forks: 734


---
Source: https://tokrepo.com/en/workflows/talk-to-figma-mcp-control-figma-from-cursor
Author: MCP Hub