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

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.

Setup with Claude

Installing via Smithery

To install Figma MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @MatthewDailey/figma-mcp --client 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

3. Restart Claude Desktop.

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

3. Build the project:

npm run build

4. For development with auto-rebuilding:

npm run watch