Skip to content
Back to search

reqwise-figma-mcp

An MCP server that lets AI agents read and draw on the Figma canvas — safely. Paired with a Figma plugin, it provides structured verification, safe-by-default drawing, and resilient multi-window support for Claude Code, Codex, Cursor, and other MCP clients.

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/hoangpm96--reqwise-figma-mcp/badge.svg)](/listings/hoangpm96--reqwise-figma-mcp)

HTML

<a href="/listings/hoangpm96--reqwise-figma-mcp"><img src="/api/listings/hoangpm96--reqwise-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.

git clone https://github.com/hoangpm96/reqwise-figma-mcp.git
cd reqwise-figma-mcp
npm install
npm run build

This builds the server to `dist/` and the plugin bundle to `plugin/code.js`.

**Register the MCP server** — all editors at once (Cursor, Claude Code, Codex):

npm run install:mcp

or one editor by hand:

claude mcp add reqwise-figma -s user -- /absolute/path/to/reqwise-figma-mcp/scripts/reqwise-mcp.sh

**Import the plugin into Figma Desktop:** menu → **Plugins → Development → Import plugin from manifest…** → select `plugin/manifest.json`. Run it from **Plugins → Development → Reqwise Figma MCP** and keep its window open.

**Check the connection:** ask your agent to call `figma_status`. Full walkthrough and troubleshooting: [`docs/SETUP.md`](./docs/SETUP.md) and [`docs/INSTALL.md`](./docs/INSTALL.md). Several editors at once: [`docs/MULTI-AGENT.md`](./docs/MULTI-AGENT.md).

> **Every session:** open your Figma file → **Plugins → Development → Reqwise Figma MCP** → leave the window open. Figma doesn't auto-start plugins.

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 · 226 lines

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

  1. # Reqwise Figma MCP
  2. ![Reqwise Figma MCP — AI agents read and draw on the Figma canvas, safely: an open-source local MCP server plus Figma plugin for Claude Code, Cursor and Codex](docs/assets/hero.png)
  3. **An MCP server that lets AI agents read and draw on the Figma canvas — safely.** Open source (MIT).
  4. > **Need BPMN, UI templates, a 1-to-1 code ↔ Figma component map, design systems, journey maps, personas, accessibility and responsive audits, or self-playing demos?**
  5. > They are in **[Reqwise Figma MCP Pro →](https://ai4ba.com/figma-mcp)**. Compare the two editions [below](#free-vs-pro).
  6. Reqwise Figma MCP pairs a local MCP server with a companion Figma plugin. Point Claude Code, Cursor, Codex or any MCP-capable agent at it, and the agent can inspect a Figma file and draw into it by executing JavaScript against a `figma.*` proxy API — with the plugin layer catching the mistakes that usually turn "AI draws a screen" into "AI draws an overflowing, half-clipped mess." It also draws the BA diagrams a spec needs — userflow, activity, sequence, ERD, sitemap, state machine — and proof-reads the model behind each one.
  7. It exists because the current generation of Figma MCPs make agents responsible for discipline they don't have: remembering never to overlay a semi-transparent frame, re-declaring token maps every call, manually computing x/y offsets, eyeballing screenshots to check for clipping. Reqwise moves that discipline into the server and plugin, and gives the agent a structured way to verify its own work.
  8. ## Free vs Pro
  9. ![Free vs Pro at a glance — Free (MIT): bridge and multi-agent, read/draw canvas, layout_audit, tokens and styles, icons/images/prototypes, six BA diagrams and their Claude skills. Pro adds components and properties, design-system generation, use case, BPMN, journey and persona diagrams, UI section and block templates, a 1-to-1 code to Figma component map, accessibility and responsive audits, self-playing demos and video recording](docs/assets/free-vs-pro.png)
  10. <!-- features:begin -->
  11. | Feature | Free | Pro |
  12. |---|:---:|:---:|
  13. | **Connection** | | |
  14. | Figma bridge with rich diagnostics and next-step hints | ✅ | ✅ |
  15. | Several Figma windows and several AI agents at once (leader/follower) | ✅ | ✅ |
  16. | One launcher for Claude Code, Cursor and Codex | ✅ | ✅ |
  17. | Hardened local bridge (sandboxed JS, authenticated forwarding) | ✅ | ✅ |
  18. | Rule sheet and on-demand docs for the agent | ✅ | ✅ |
  19. | **Read and draw on the canvas** | | |
  20. | Read pages, layers, selection; screenshots and exports | ✅ | ✅ |
  21. | Draw and edit frames, text, shapes; streaming batches | ✅ | ✅ |
  22. | Layout audit — overflow, clipping, truncated text | ✅ | ✅ |
  23. | New work never lands on top of existing work | ✅ | ✅ |
  24. | Tokens and variables — create, bind, edit, import/export | ✅ | ✅ |
  25. | Text styles and effect styles | ✅ | ✅ |
  26. | Icons, images, overlays, gradients, recolor | ✅ | ✅ |
  27. | Prototype reactions | ✅ | ✅ |
  28. | Delete pages and styles, sweep unused styles | ✅ | ✅ |
  29. | Read an existing design system; export design-kit.md | ✅ | ✅ |
  30. | Components — find, create, variants, instances | — | ✅ |
  31. | Component properties — booleans, nested instances, edit/delete | — | ✅ |
  32. | Design-system compliance audit and auto-binding | — | ✅ |
  33. | **BA diagrams** | | |
  34. | Userflow | ✅ | ✅ |
  35. | Activity diagram with swimlanes | ✅ | ✅ |
  36. | Sequence diagram | ✅ | ✅ |
  37. | ERD | ✅ | ✅ |
  38. | Sitemap | ✅ | ✅ |
  39. | State machine | ✅ | ✅ |
  40. | Arrows follow the boxes; edit a diagram in place | ✅ | ✅ |
  41. | Cross-check diagrams against each other | ✅ | ✅ |
  42. | Use case diagram | — | ✅ |
  43. | BPMN process diagram — pools, lanes, events, gateways, message flows | — | ✅ |
  44. | User journey map (several layouts and themes) | — | ✅ |
  45. | Persona set | — | ✅ |
  46. | **Design system** | | |
  47. | Generate a design system — 60 components, tokens, screen grids, doc pages | — | ✅ |
  48. | 10 visual styles, side-by-side preview, AI style recommendation | — | ✅ |
  49. | Learn a system from the canvas or from design.md | — | ✅ |
  50. | 1-to-1 map between your code components and Figma components — props ↔ variants, kept in sync both ways | — | ✅ |
  51. | The tool asks the user the right questions, with time estimates | — | ✅ |
  52. | **UI templates** | | |
  53. | Section and block templates — hero, nav, pricing, data table, form, empty state | — | ✅ |
  54. | Templates drawn with *your* components and tokens, not pasted stock art | — | ✅ |
  55. | Start a design system from a template — palette and visual style preconfigured | — | ✅ |
  56. | **Quality and presentation** | | |
  57. | Accessibility audit — contrast, touch targets, unnamed controls | — | ✅ |
  58. | Responsive audit — stretch a screen, compare mobile and desktop | — | ✅ |
  59. | Self-playing prototype demos | — | ✅ |
  60. | Record a demo to video | — | ✅ |
  61. | **Claude skills** | | |
  62. | /figma-userflow, /figma-activity, /figma-sequence, /figma-erd, /figma-sitemap, /figma-state | ✅ | ✅ |
  63. | /figma-usecase, /figma-journey, /figma-persona, /figma-design-system, /figma-demo | — | ✅ |
  64. <!-- features:end -->
  65. **[Get Pro →](https://ai4ba.com/figma-mcp)** — this table is generated from the feature list both editions ship from, so it is current with every release.
  66. ## Why this one
  67. | | Typical Figma MCP | Reqwise Figma MCP |
  68. |---|---|---|
  69. | Verification | Screenshot only — agent eyeballs pixels | `layout_audit` returns declared vs. rendered bounds, `overflowsParent`, `clippedBy`, `textTruncated` per node; screenshots stay for final human review |
  70. | Overlays / scrims | Agent dims a screen with an opacity'd FRAME (dims the whole subtree) | `figma.overlay()` creates a correctly layered RECTANGLE — the mistake is structurally unavailable |
  71. | Session state | Token maps and id registries re-declared every call | `state` is a persistent object per session; set up tokens once, reuse across calls |
  72. | Connection | Silent boolean, or a dead WS with no explanation | `figma_status` returns diagnostics plus an ordered `hints` list of concrete next steps |
  73. | Multiple IDE windows | Second server instance fights for the port or silently fails | Leader/follower election; followers forward through an authenticated `/rpc` to the one leader holding the plugin connection |
  74. | Batch operations | Hard caps (e.g. 50 ops) with all-or-nothing failure | Chunked streaming, partial commit, exact per-index error reporting, no hard cap |
  75. | Structural frames | Figma's default white fill turns layout wrappers into accidental white slabs | FRAME/COMPONENT without an explicit fill defaults to transparent; visible surfaces opt in |
  76. | Sandbox JS | Restricted/older syntax (no `?.`, `??`, spread) | Node `vm` — full modern ES (optional chaining, nullish coalescing, spread, async/await) |
  77. | Errors | Bare exceptions | Every failure carries `{code, message, hint}` — the hint is the next concrete step |
  78. | Edit-in-place | Draw-from-scratch focus; per-op fights the single-threaded plugin | Selection-first workflow (`readSelection` → modify → `layout_audit`), instance-override "format painter", recursive recolor, mixed-font-safe text edits; writes serialized per connection so mutations never race |
  79. | Diagrams | Mermaid/plantuml text rendered to an image — each diagram an island | Every diagram frame **stores the model it was drawn from**: change one with `update` + `patch` instead of re-authoring it, and let the tools ask whether the diagrams on the page contradict each other |
  80. | Business rules with a number | The `10 minutes` retyped into four diagrams; one gets updated, the others don't | `options.policies` holds the value once and labels reference it as `@hold-minutes` — a label cannot drift from a number it doesn't hold |
  81. See [`ARCHITECTURE.md`](./ARCHITECTURE.md) for the full design rationale and the root-cause fixes behind these defaults.
  82. ## Quickstart
  83. ![How Reqwise works — 1. install the MCP (npm install, npm run build, register in Cursor/Claude/Codex), 2. import the plugin in Figma Desktop from manifest.json, 3. open your file and keep the plugin window open, 4. call figma_status, then figma_read / figma_write / figma_diagram, then layout_audit](docs/assets/how-it-works.png)
  84. ```bash
  85. git clone https://github.com/hoangpm96/reqwise-figma-mcp.git
  86. cd reqwise-figma-mcp
  87. npm install
  88. npm run build
  89. ```
  90. This builds the server to `dist/` and the plugin bundle to `plugin/code.js`.
  91. **Register the MCP server** — all editors at once (Cursor, Claude Code, Codex):
  92. ```bash
  93. npm run install:mcp
  94. ```
  95. or one editor by hand:
  96. ```bash
  97. claude mcp add reqwise-figma -s user -- /absolute/path/to/reqwise-figma-mcp/scripts/reqwise-mcp.sh
  98. ```
  99. **Import the plugin into Figma Desktop:** menu → **Plugins → Development → Import plugin from manifest…** → select `plugin/manifest.json`. Run it from **Plugins → Development → Reqwise Figma MCP** and keep its window open.
  100. **Check the connection:** ask your agent to call `figma_status`. Full walkthrough and troubleshooting: [`docs/SETUP.md`](./docs/SETUP.md) and [`docs/INSTALL.md`](./docs/INSTALL.md). Several editors at once: [`docs/MULTI-AGENT.md`](./docs/MULTI-AGENT.md).
  101. > **Every session:** open your Figma file → **Plugins → Development → Reqwise Figma MCP** → leave the window open. Figma doesn't auto-start plugins.
  102. ## Tools
  103. | Tool | Purpose |
  104. |---|---|
  105. | `figma_status` | Rich connection diagnostics — plugin connection, leader/follower mode, heartbeat, queue, sessions, and an ordered `hints` list. Never a bare boolean. |
  106. | `figma_read` | Read the canvas via an `op` enum (`get_document_info`, `get_selection`, `read_selection`, `get_design_context`, `get_design_system_kit`, `generate_design_md`, `search_nodes`, `screenshot`, `layout_audit`, `get_diagram_spec`, `get_page_model`, ...) with token-frugal responses. |
  107. | `figma_write` | Execute modern-ES JavaScript against the `figma.*` proxy to create/modify the canvas. `state` persists per session. |
  108. | `figma_rules` | One-call design-system rule sheet (styles + variables + components) as markdown — read before drawing so you reuse instead of hardcode. For a durable spec, use `figma_read` op `generate_design_md` and save the returned markdown as `design-kit.md`. |
  109. | `figma_diagram` | Draw **six** diagram kinds from a model **you** derived from the spec, each with findings on the *content*, not the drawing. `type:"activity"` — a business process, with swimlanes or without: one band per owner, the handoffs between bands; reports an unlabelled handoff, a step nobody owns, a fork that never joins. `type:"sequence"` — an exchange over time: participants as columns, messages in the order you list them, activation bars derived from the calls and their replies, alt/loop blocks; reports a call nobody answers, a reply with no call, an alt with no else. `type:"state"` — the lifecycle of ONE entity: the values it can hold and every change that is allowed, written `event [guard] / action`; reports a state nothing can reach, a state nothing can leave, two transitions racing on one event. `type:"erd"` — a data model: tables, columns, keys, crow's-foot cardinality; reports what bites after a migration (no primary key, a foreign key to a column that does not exist, a many-to-many with no join table). `type:"userflow"` — the screens a user moves through, from a graph or a mermaid `flowchart`; reports a question with one way out, a dead end, an unreachable screen. `type:"sitemap"` — the pages a product is made of and what contains what, drawn as a tidy tree; reports an orphan page, a section with nothing under it, a depth nobody will navigate, and cross-checks against the userflows on the page. Write any of them in the compact `text` form at ~a third of the tokens, draw a whole set in one call (`diagrams: [...]`, placed for you), and **change** one with `update` + `patch` instead of re-authoring it. Every draw is cross-checked against the other diagrams on the page. Arrows stay attached on all of them: drag a box and every line touching it re-routes. |
  110. | `figma_docs` | On-demand documentation: `rules` \| `layout` \| `api` \| `tokens` \| `icons` \| `recipes` \| `style` \| `userflow` \| `activity` \| `erd` \| `sequence` \| `sitemap` \| `state`. Read `style` when there's no design system to reuse — it's the brand-neutral default scale/palette/elevation to fall back on instead of inventing values. |
  111. Full parameter reference for every operation and every `figma.*` method: [`docs/TOOLS.md`](./docs/TOOLS.md). Pro adds `figma_design_system` and `figma_record`, four more diagram kinds (use case, BPMN, journey map, persona set), the UI templates, the code ↔ Figma component map and the audits — see [Free vs Pro](#free-vs-pro).
  112. ## Diagram skills
  113. [`.claude/skills/`](./.claude/skills/) ships a skill per diagram kind — `/figma-userflow`, `/figma-activity`, `/figma-sequence`, `/figma-state`, `/figma-erd`, `/figma-sitemap` — plus the discipline they share (the connection gate, the four levels of "correct", the findings loop, verification). Copy them into `.claude/skills/` in your project. See [`.claude/skills/README.md`](./.claude/skills/README.md).
  114. ## Example: `figma_write`
  115. ```js
  116. // Set tokens once — they persist in this session's `state.tokens`.
  117. await figma.setupTokens({
  118. colors: { primary: "#2563EB", surface: "#0B0B0F" },
  119. numbers: { "radius-md": 8 },
  120. });
  121. // Draw a card with wrapping text, reusing the parent's width.
  122. const card = await figma.create({
  123. type: "FRAME", name: "Card", parentId: state.rootId,
  124. width: 320, layoutMode: "VERTICAL",
  125. });
  126. await figma.applyVariable(card.id, "fills", "surface");
  127. await figma.create({
  128. type: "TEXT", parentId: card.id, wrap: true,
  129. characters: "A long paragraph that must wrap inside the card.",
  130. });
  131. // Verify before screenshotting for a human.
  132. const audit = await figma.layoutAudit(card.id);
  133. if (audit.summary.issues.length) console.warn(audit.summary.issues);
  134. ```
  135. ## Example: snapshot a design system to `design-kit.md`
  136. Ask your agent to call:
  137. ```json
  138. { "op": "generate_design_md", "params": { "depth": 3, "includeAnatomy": true, "includeScreens": true } }
  139. ```
  140. The response contains a source-grounded markdown snapshot: extraction coverage, colors,
  141. typography, observed layout frequencies, screen composition evidence, local and
  142. remote component usage, exact node ids/keys/variant ids/property keys, ready-to-run
  143. instantiate examples, reuse rules, responsive evidence and known gaps. Save
  144. it in the target codebase as **`design-kit.md`** before asking the agent to create UI
  145. from an existing Figma component system. Facts are separated from observations and
  146. unknown UX semantics. For a very large file, tune `maxComponents`, `maxScreens`,
  147. `maxInstances` or `maxOutputChars`; output limits omit complete sections rather
  148. than cutting Markdown mid-table/code-block.
  149. > **`design.md` and `design-kit.md` are two different files** — human intent vs.
  150. > machine snapshot, like `package.json` vs. `package-lock.json`. The tools never
  151. > overwrite `design.md`. See the
  152. > [two-file workflow](./docs/RECIPES.md#the-two-file-design-system-workflow).
  153. ## Architecture
  154. ```
  155. MCP client (Claude Code / Cursor)
  156. │ stdio (MCP)
  157. ▼
  158. Reqwise MCP server (Node ≥ 18, TypeScript)
  159. │ owns HTTP+WS server on localhost:38470 (fallback +1..+9)
  160. │ GET /health → diagnostics JSON
  161. │ POST /rpc → follower → leader forwarding (auth token)
  162. │ WS /ws → Figma plugin UI connection
  163. ▼
  164. Figma Desktop plugin
  165. ├── ui.html (WebSocket client, heartbeat, reconnect w/ backoff)
  166. └── code.js (Plugin API executor, safe-default handlers)
  167. ```
  168. Every operation — leader-direct or follower-forwarded — passes through one `validateOperation()` choke point before it reaches the plugin. Full topology, the leader/follower protocol, and the 15 safe-default fixes are documented in [`ARCHITECTURE.md`](./ARCHITECTURE.md).
  169. ## Documentation
  170. - [`docs/SETUP.md`](./docs/SETUP.md) — **start here**: install, daily routine, troubleshooting
  171. - [`docs/INSTALL.md`](./docs/INSTALL.md) — installation reference: env vars, port behaviour, leader/follower
  172. - [`docs/TOOLS.md`](./docs/TOOLS.md) — full tool + `figma.*` API reference, error codes
  173. - [`docs/MIGRATION.md`](./docs/MIGRATION.md) — migrating from `figma-ui-mcp`
  174. - [`docs/RECIPES.md`](./docs/RECIPES.md) — practical cookbook
  175. - [`docs/DEMO-PROMPT.md`](./docs/DEMO-PROMPT.md) — a paste-ready prompt that demos every free diagram kind plus mobile screens
  176. - [`ARCHITECTURE.md`](./ARCHITECTURE.md) — design goals and internals
  177. ## Reqwise Figma MCP Pro
  178. Pro is the full edition, built by the same author on this same core: a design-system generator with ten visual styles, use case and **BPMN** diagrams, journey maps and persona sets, component authoring, **UI section and block templates** that draw with your own components and tokens (and design-system templates that come with palette and visual style preconfigured), a **1-to-1 map between your code components and their Figma counterparts** (props ↔ variants, so generated UI matches the codebase instead of resembling it), accessibility and responsive audits, self-playing demos and demo videos. **[ai4ba.com/figma-mcp](https://ai4ba.com/figma-mcp)**
  179. ## License
  180. MIT — see [`LICENSE`](./LICENSE). Reqwise Figma MCP Pro is a separate, commercially licensed product.

Ratings and comments

Sign in to rate this skill.

Sign in

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