# Figma MCP Server

Local MCP server providing Figma REST API access inside your AI editor. Inspect node trees, retrieve design tokens, and fetch rendered frames.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: planetabhi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/planetabhi/figma-mcp-server
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/planetabhi-figma-mcp-server

## What it does

The server maps Figma REST endpoints to 50 distinct MCP tools operating over stdio. It dynamically detects endpoints from `tools/figma/` during startup and validates incoming parameters prior to network requests. Agents can query file trees, export rendered images, view version history, and inspect project comments.

Authentication relies on a personal access token passed in `FIGMA_API_KEY`. Workspace plan tier limits still apply. Variable inspection and batch updates require an Enterprise Figma plan, while library analytics require an Organization tier. If your account lacks these tiers, requests to those endpoints fail immediately.

The codebase targets Bun 1.2 or higher. Setup requires executing the server via `bunx` or `npx` with the API token exported in the client configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FIGMA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Figma

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add figma-mcp-server -e FIGMA_API_KEY=<FIGMA_API_KEY> -- npx -y figma-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add planetabhi-figma-mcp-server --env FIGMA_API_KEY=<FIGMA_API_KEY> -- npx -y figma-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "planetabhi-figma-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "figma-mcp-server"
            ],
            "env": {
                "FIGMA_API_KEY": "<FIGMA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "planetabhi-figma-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "figma-mcp-server"
            ],
            "env": {
                "FIGMA_API_KEY": "<FIGMA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FIGMA_API_KEY=<FIGMA_API_KEY> planetabhi-figma-mcp-server npx -y figma-mcp-server
```
Replace <…> with your own values

## When to use it
- inspect layer hierarchies and node properties in Figma files
- fetch image renders for specific UI frames and icons
- extract design tokens and variables from design libraries
- review comments and discussion threads on design files

## Example prompts
- Inspect the component hierarchy for the file key I provided.
- Generate image render URLs for all icons inside this frame.
- Fetch the list of published design tokens from our Figma library.

## Similar
- [understand-figma](https://affpapa.org/en/nevibecode/skills/understand-figma.md) — skill · 1800 installs
- [figma-designer](https://affpapa.org/en/nevibecode/skills/figma-designer.md) — skill · 807 installs
- [figma](https://affpapa.org/en/nevibecode/plugins/figma.md) — plugin · ★ 2119
- [figma-codegen](https://affpapa.org/en/nevibecode/skills/figma-codegen.md) — skill · 1300 installs
- [pp-figma](https://affpapa.org/en/nevibecode/skills/pp-figma.md) — skill · 726 installs
- [figma-integration](https://affpapa.org/en/nevibecode/skills/figma-integration.md) — skill · 718 installs

## Other versions with the same name
- [Figma MCP Server · figma](https://affpapa.org/en/nevibecode/mcp/figma-mcp-server.md) — ★ 2119

---
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