DocsIntegrationsFigma MCP
mcp-figma
MCP Server

Figma MCP

Read Figma design files, components, and variables via Figma's official hosted remote MCP server

Figma's official hosted remote MCP server (mcp.figma.com/mcp) gives your Agent nodes read access to design files, components, styles, variables, and dev resources through the Model Context Protocol. Agents can fetch file structures, inspect frames and components, read variable collections, and retrieve dev mode metadata — all auto-discovered at connection time via tools/list. The server uses HTTP transport and authenticates with an OAuth 2.0 access token issued by Figma. No self-hosting or local server setup is required.

Official documentation

Setup

1

Get a Figma OAuth access token

The remote Figma MCP server requires an OAuth 2.0 access token — not a Personal Access Token. Connect Figma MCP via a compatible client such as Claude Desktop or Cursor to complete Figma's OAuth flow and obtain your access token. See Figma's guide for full instructions.

Figma MCP guide
2

Add the integration in CipherSense Agents

Go to Project > Integrations > Add Integration > Figma MCP. The endpoint is pre-filled and locked to https://mcp.figma.com/mcp. Paste your OAuth access token into the form and click Save & Test.

3

Use in a workflow

Add a Figma MCP node to your workflow canvas. Select a tool from the auto-discovered list (e.g. get_file, get_component, get_variables) and pass the Figma file key or node ID from upstream nodes.

Connection Fields

Fields required when adding this integration in your Project › Integrations.

FieldRequiredDescription
MCP Endpoint
Required
Pre-filled and locked to Figma's official hosted remote MCP server. Not editable.
OAuth Access Token
Required
OAuth 2.0 access token issued by Figma for the remote MCP server. Obtained by completing Figma's OAuth flow via a compatible MCP client.

Common Use Cases

Extract design tokens and variables for automated style guidesRead component metadata for AI-assisted design documentationFetch frame content for design-to-code workflowsRetrieve dev mode annotations and specs for handoff automationInspect file structure to audit component usage across projects

Available Tools

9

Tools exposed by this MCP server and available to Agent nodes in your workflows.

generate_diagramget_design_contextget_screenshotget_metadatacreate_design_system_rulesget_variable_defsget_code_connect_mapget_figjamwhoami

Common Errors

Known errors and how to resolve them.

401 UnauthorizedTest Connection

Why this happens

The OAuth access token is invalid or has expired.

How to fix

Re-authenticate with Figma via a compatible MCP client to obtain a fresh OAuth access token and update the integration.

tools/list returned empty arrayWorkflow Execution

Why this happens

The server responded but returned no tools, which typically indicates the access token lacks the required Figma permissions.

How to fix

Ensure your Figma account has access to the relevant files and that the OAuth token was granted the correct scopes during authorisation.

Ready to connect Figma MCP?

Add this integration from your project dashboard and wire it into a workflow.