figma-mcp

MCP.Pizza Chef: MatthewDailey

The Figma MCP server is a ModelContextProtocol adapter that integrates Figma's REST API with AI assistants. It allows models to interact with Figma files by viewing design content, reading and posting comments, and analyzing design elements in real time. This server facilitates seamless collaboration and design review workflows by embedding Figma context directly into AI chat environments like Claude. Setup involves obtaining a Figma API key with appropriate scopes and configuring the MCP server to connect with AI clients, enabling enhanced design interaction and feedback automation.

Use This MCP server To

View Figma design files within AI chat environments Post and read comments on Figma designs via AI assistants Analyze design elements programmatically through AI Integrate Figma design context into collaborative AI workflows Automate design feedback collection using AI Enable real-time design review with AI-powered tools

README

Figma MCP Server

A ModelContextProtocol server that enables AI assistants to interact with Figma files. This server provides tools for viewing, commenting, and analyzing Figma designs directly through the ModelContextProtocol.

Features

  • Add a Figma file to your chat with Claude by providing the url
  • Read and post comments on Figma files

Setup with Claude

  1. Download and install Claude desktop app from claude.ai/download

  2. Get a Figma API Key (figma.com -> click your name top left -> settings -> Security). Grant File content and Comments scopes.

  3. Configure Claude to use the Figma MCP server. If this is your first MCP server, run the following in terminal.

echo '{
  "mcpServers": {
    "figma-mcp": {
      "command": "npx",
      "args": ["figma-mcp"],
      "env": {
        "FIGMA_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

If it's not, copy the figma-mcp block to your claude_desktop_config.json

  1. Restart Claude Desktop.

  2. Look for the hammer icon with the number of available tools in Claude's interface to confirm the server is running.

Example usage

Start a new chat with claude desktop and paste the following

What's in this figma file?

https://www.figma.com/design/MLkM98c1s4A9o9CMnHEyEC

Demo of a more realistic usage

https://www.loom.com/share/0e759622e05e4ab1819325bcf6128945?sid=bcf6125b-b5de-4098-bf81-baff157e3dc3

Development Setup

Running with Inspector

For development and debugging purposes, you can use the MCP Inspector tool. The Inspector provides a visual interface for testing and monitoring MCP server interactions.

Visit the Inspector documentation for detailed setup instructions and usage guidelines.

The command to test locally with Inspector is

npx @modelcontextprotocol/inspector npx figma-mcp

Local Development

  1. Clone the repository
  2. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. For development with auto-rebuilding:
npm run watch

Available Tools

The server provides the following tools:

  • add_figma_file: Add a Figma file to your context by providing its URL
  • view_node: Get a thumbnail for a specific node in a Figma file
  • read_comments: Get all comments on a Figma file
  • post_comment: Post a comment on a node in a Figma file
  • reply_to_comment: Reply to an existing comment in a Figma file

Each tool is designed to provide specific functionality for interacting with Figma files through the ModelContextProtocol interface.

figma-mcp FAQ

How do I obtain the Figma API key required for the figma-mcp server?
You can get your Figma API key by logging into figma.com, clicking your name in the top left, navigating to Settings > Security, and generating a key with 'File content' and 'Comments' scopes enabled.
What permissions does the figma-mcp server need from Figma?
The server requires 'File content' and 'Comments' scopes to read design files and manage comments.
How do I configure the figma-mcp server with Claude?
After installing Claude, create a configuration file specifying the figma-mcp command and set the FIGMA_API_KEY environment variable with your API key as shown in the setup instructions.
Can the figma-mcp server post comments on Figma files?
Yes, it supports both reading and posting comments on Figma files through the ModelContextProtocol interface.
Is the figma-mcp server limited to Claude, or can it work with other AI clients?
While setup instructions focus on Claude, the server is compatible with any MCP client that supports the protocol, including those using OpenAI, Anthropic Claude, and Google Gemini models.
What kind of Figma files can the figma-mcp server access?
It can access any Figma file for which the API key has permission, allowing full interaction with design content and comments.
Does the figma-mcp server support real-time updates from Figma?
The server provides access to current file content and comments but depends on client polling or event mechanisms for real-time synchronization.
How secure is the figma-mcp server when handling API keys?
The server uses environment variables to securely store API keys and follows MCP principles for scoped and secure model interaction.