# figma-mcp-server

A skill that teaches an agent to read Figma files over MCP: frame-to-code, design tokens, and beta writes back to the canvas.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 195 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/figma-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/figma-mcp-server

## What it does

The skill spells out which tools an agent should call to get data out of Figma. Hand it a frame link and `get_design_context` returns the node as React with Tailwind by default, adapting to another framework. `get_screenshot` supplies a picture of the selection, `get_variable_defs` returns tokens, and `get_metadata` helps when a full response gets cut and the `node-id` has to be found first.

Instructions alone do nothing, so the remote server at `https://mcp.figma.com/mcp` has to be connected and authorised (`/mcp auth figma` in Claude).

Writing to the canvas is beta and remote-only: `create_frame`, `create_component`, `create_variable`, `update_auto_layout`. Code Connect makes the agent emit your own components, though the mappings must be linked in the repo beforehand. Mind the seat you hold: Starter, View and Collab allow 6 tool calls a month, so a Dev or Full seat is what makes this workable.

## Requirements
- Works with: Figma

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill figma-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/figma-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/figma-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill figma-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/figma-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill figma-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/figma-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/figma-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/figma-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill figma-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/figma-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/figma-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill figma-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/figma-mcp-server/SKILL.md

## When to use it
- turn a Figma frame into a React component
- pull colours, spacing and type into tokens
- reuse the project's own components through Code Connect
- create a button in Figma from design-system tokens
- find node ids when a design response comes back cut

## Example prompts
- Implement this design: `https://www.figma.com/design/abc123?node-id=45-678`
- Pull the tokens out of this Figma file: colours, spacing, typography
- Create a primary button component in Figma using our design-system tokens

## Similar
- [figma-integration](https://affpapa.org/en/nevibecode/skills/plugin87-figma-integration.md) — skill · 554 installs
- [Figma MCP Server](https://affpapa.org/en/nevibecode/mcp/figma-mcp-server.md) — MCP server · ★ 2221 repo stars
- [figma](https://affpapa.org/en/nevibecode/plugins/figma.md) — plugin · ★ 2221 repo stars
- [figma-code-connect-components](https://affpapa.org/en/nevibecode/skills/openai-figma-code-connect-components.md) — skill · 3000 installs
- [Figma Developer](https://affpapa.org/en/nevibecode/skills/figma-developer.md) — skill · 152 installs
- [figma-codegen](https://affpapa.org/en/nevibecode/skills/figma-codegen.md) — skill · 1700 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
