Skip to main content
Glama
Custom Figma MCP

Custom Figma MCP

by mahmudcoding

Custom Figma MCP

Use Codex or Claude Code to inspect and edit the Figma file that is open in Figma Desktop.

This is a local tool. It does not use the official Figma MCP, Figma OAuth, Figma API keys, file keys, or Figma web URLs for normal editing.

Install First

1. Install Requirements

  • Figma Desktop

  • Node.js 22.5 or newer

  • pnpm 10.25 or newer

If pnpm is missing, ./run.sh will try to enable it with Corepack.

2. Start This Project

Open Terminal:

cd /path/to/figma-mcp
./run.sh

Keep this Terminal window open while you use Figma MCP.

3. Add The Figma Plugin Once

  1. Open Figma Desktop.

  2. Go to Plugins -> Development -> Import plugin from manifest....

  3. Select figma-plugin/manifest.json from this project.

  4. Run Plugins -> Development -> Custom Figma MCP Bridge.

The plugin should show Connected.

4. Connect Your AI Tool

For Codex:

codex mcp add custom-figma-mcp -- /bin/zsh -lc 'cd /path/to/figma-mcp && node mcp-server/dist/index.js'

For Claude Code:

claude mcp add --transport stdio custom-figma-mcp -- /bin/zsh -lc 'cd /path/to/figma-mcp && node mcp-server/dist/index.js'

Use the real full path to this folder.

After adding it, restart Codex or Claude Code.

Related MCP server: finish-line

Daily Use

  1. Open the Figma file in Figma Desktop.

  2. In Terminal, run:

cd /path/to/figma-mcp
./run.sh
  1. In Figma Desktop, run Plugins -> Development -> Custom Figma MCP Bridge.

  2. Start Codex or Claude Code.

  3. Ask it to inspect or edit the open Figma file.

Check That It Works

Run:

curl http://localhost:3333/health

Good result:

{
  "ok": true,
  "pluginConnected": true
}

If pluginConnected is false, open Figma Desktop, open your file, and run Plugins -> Development -> Custom Figma MCP Bridge.

What This Does

This project creates a local bridge:

Codex / Claude Code
  -> local MCP server
  -> local WebSocket
  -> Figma Desktop plugin
  -> your open Figma file

The AI tool can read and edit the file that is currently open in Figma Desktop.

It can create and update frames, text, rectangles, components, auto-layout frames, styles, variables, and other supported Figma Plugin API objects.

Common Problems

The Plugin Says Reconnecting

  1. Make sure ./run.sh is still running.

  2. Click Reconnect in the plugin.

  3. If it still fails, close and run the plugin again from Plugins -> Development.

The Health Check Says pluginConnected false

The local server is running, but Figma Desktop is not connected.

Open Figma Desktop, open the target file, and run Custom Figma MCP Bridge.

Codex Or Claude Does Not Show The Tools

Restart Codex or Claude Code after adding the MCP server.

In Codex or Claude Code, run /mcp and look for custom-figma-mcp.

More Help

Developer Commands

pnpm install
pnpm build
pnpm typecheck
pnpm doctor
pnpm test:integration
./run.sh --check

Available Tools

29 tools
figma.batch_operationsBatch operationsB

Run multiple plugin commands in sequence with undo-backed transactional rollback by default.

Inputs: operations (required), transactional, continueOnError, rollbackOnError.

figma.call_apiCall raw Figma Plugin APIC

Dynamically call any Plugin API method on figma, a node, page, style, variable, or API namespace.

Inputs: method (required), target (required), args, nodeId, +6 more.

figma.create_autolayoutCreate auto-layoutC

Create a Figma auto-layout frame.

Inputs: x, y, name, index, +6 more.

figma.create_componentCreate componentC

Create a native Figma component.

Inputs: x, y, name, index, +6 more.

figma.create_frameCreate frameC

Create a native Figma frame.

Inputs: x, y, name, index, +6 more.

figma.create_nodeCreate via any figma.create* APIB

Call any current or future figma.create* method discovered from official typings, then optionally set properties and reparent the result.

Inputs: createMethod (required), args, index, pageId, +2 more.

figma.create_rectangleCreate rectangleC

Create a native Figma rectangle.

Inputs: x, y, name, index, +5 more.

figma.create_textCreate textB

Create editable native Figma text, loading the requested font first.

Inputs: x, y, name, index, +9 more.

figma.delete_nodeDelete nodeC

Delete a node from the open Figma file.

Inputs: nodeId (required), hardDelete.

figma.duplicate_nodeDuplicate nodeC

Duplicate a node by cloning it.

Inputs: nodeId (required), offsetX, offsetY, parentId.

figma.export_nodeExport nodeC

Export a node as PNG, JPG, SVG, or PDF and return base64 content.

Inputs: nodeId (required), scale, format.

figma.find_nodesFind nodesC

Search nodes by name, type, CSS-like query, page, or document scope.

Inputs: type, query, pageId, allPages, +3 more.

figma.get_api_schemaGet generated Figma API schemaC

Return the generated contract parsed from official Figma Plugin API typings and REST OpenAPI sources.

Inputs: limit, category, memberName, objectName, +2 more.

figma.get_current_pageGet current pageA

Return serialized data for the current Figma page.

Inputs: no named parameters.

figma.get_documentGet Figma documentA

Return serialized pages and top-level nodes from the open Figma document.

Inputs: no named parameters.

figma.get_nodeGet nodeC

Return serialized data for a specific node.

Inputs: nodeId (required).

figma.get_propertyGet raw Figma Plugin API propertyC

Read any serializable Plugin API property from figma, a node, page, style, variable, or API namespace.

Inputs: target (required), property (required), nodeId, pageId, +5 more.

figma.get_selectionGet selectionA

Return serialized data for the current Figma selection.

Inputs: no named parameters.

figma.list_stylesList stylesA

List local text, paint, effect, and grid styles.

Inputs: no named parameters.

figma.list_variablesList variablesA

List local variable collections and variables.

Inputs: no named parameters.

figma.move_nodeMove nodeC

Move a node within the canvas or reparent it.

Inputs: nodeId (required), x, y, index, +1 more.

figma.poll_eventsPoll Figma eventsC

Poll queued Figma Plugin API events captured by subscribe_event.

Inputs: limit, eventType, sinceSequence.

figma.resize_nodeResize nodeD

Resize a node.

Inputs: width (required), height (required), nodeId (required).

figma.rest_requestCall raw Figma REST APIC

Call any official Figma REST API operation by operationId or raw method/path using stored OAuth tokens.

Inputs: body, path, query, method, +4 more.

figma.set_propertySet raw Figma Plugin API propertyC

Set any writable Plugin API property on figma, a node, page, style, variable, or API namespace.

Inputs: value (required), target (required), property (required), nodeId, +6 more.

figma.subscribe_eventSubscribe to Figma eventC

Subscribe to a Figma Plugin API event on figma or another event-capable API target and queue events for polling.

Inputs: eventType (required), once, nodeId, pageId, +9 more.

figma.unsubscribe_eventUnsubscribe from Figma eventA

Remove a previously registered Figma Plugin API event subscription by subscription id or event type.

Inputs: eventType, subscriptionId.

figma.update_nodeUpdate nodeC

Update node properties, styles, layout, bounds, or text.

Inputs: nodeId (required), name, style, bounds, +5 more.

figma.update_variableUpdate variableC

Update a local or imported Figma variable mode value.

Inputs: value (required), modeId (required), variableId, variableKey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 29 tools

    Disambiguation4/5

    Most tools target distinct operations, but `figma.create_node` overlaps with specific create tools, and `figma.set_property` overlaps with `figma.update_node`. Descriptions help clarify, but some ambiguity remains.

    Naming Consistency5/5

    All tools follow a consistent `figma.verb_noun` pattern (e.g., `create_frame`, `get_node`), with no mixing of conventions.

    Tool Count4/5

    29 tools cover a broad range of Figma operations, but some tools could be merged (e.g., `call_api` and `rest_request`). Still, it's reasonably scoped for a comprehensive MCP server.

    Completeness3/5

    Covers node CRUD, styles/variables listing, events, and API access, but missing create for styles/variables and page management. Notable gaps for a full design tool surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to inspect Figma selections, navigate pages, render previews, generate starter code, and submit user-approved canvas edits through a local bridge.
      3 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to read, create, edit, and organize Figma documents directly through a local plugin bridge, without needing a Figma AI subscription.
      3
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI coding agents to read and edit the file currently open in Figma Desktop through a local development plugin, supporting node inspection, JSON/image exports, and arbitrary Plugin API scripts without REST API rate limits.
      7
      11 npm
      MIT