Happy slice of mcp pizzaMCP.pizza

figma-mcp-server

MCP.Pizza Chef: TimHolden

Two tools are actually live and both only read: one lists the files sitting in a Figma project, the other returns a file's name, version, editor type, last-edited date and a count of its layers, components and styles. The readme also advertises creating variables and themes, but those never appear in the tool menu and the code behind them fails on its first line if reached, so treat them as absent. A personal Figma token is required and sits in plain text in your settings. Nothing has changed here since March 2025.

Unmaintained · no commits since March 2025; advertised features never finished
Coding
Images/Design

Use This MCP server To

Check when a Figma file was last edited See how many components a design file contains List every file inside one Figma project Confirm which version of a design is current Get a quick size read on an unfamiliar design file

README

Figma MCP Server

A Model Context Protocol (MCP) server that provides integration with Figma's API through Claude and other MCP-compatible clients. Currently supports read-only access to Figma files and projects, with server-side architecture capable of supporting more advanced design token and theme management features (pending Figma API enhancements or plugin development).

Project Status

Current Progress

  • ✅ Core Implementation: Successfully built a TypeScript server following the Model Context Protocol (MCP)
  • ✅ Claude Desktop Integration: Tested and functional with Claude Desktop
  • ✅ Read Operations: Working get-file and list-files tools for Figma file access
  • ✅ Server Architecture: Caching system, error handling, and stats monitoring implemented
  • ✅ Transport Protocols: Both stdio and SSE transport mechanisms supported

Potential Full Functionality

The server has been designed with code to support these features (currently limited by API restrictions):

  • Variable Management: Create, read, update, and delete design tokens (variables)
  • Reference Handling: Create and validate relationships between tokens
  • Theme Management: Create themes with multiple modes (e.g., light/dark)
  • Dependency Analysis: Detect and prevent circular references
  • Batch Operations: Perform bulk actions on variables and themes

With Figma plugin development or expanded API access, these features could be fully enabled.

Features

  • 🔑 Secure authentication with Figma API
  • 📁 File operations (read, list)
  • 🎨 Design system management
    • Variable creation and management
    • Theme creation and configuration
    • Reference handling and validation
  • 🚀 Performance optimized
    • LRU caching
    • Rate limit handling
    • Connection pooling
  • 📊 Comprehensive monitoring
    • Health checks
    • Usage statistics
    • Error tracking

Prerequisites

  • Node.js 18.x or higher
  • Figma access token with appropriate permissions
  • Basic understanding of MCP (Model Context Protocol)

figma-mcp-server FAQ

Is this still maintained?
No. The last commit was March 2025, and several advertised features were never finished. Expect it to stay as-is.
Can I use this to change colours or edit a design?
No. Only reading works. The create, update and delete tools described in the readme are never offered to the assistant, and Figma's own personal tokens are read-only anyway, so writing was never possible.
Do I need a key?
Yes. You generate a personal access token in your Figma account settings and paste it into the config. It grants read access to every file that account can see, so treat it like a password.
Does it show me the actual design content?
Not really. You get file summary facts and counts, not the frames, layers, text or colours themselves. It is closer to a file-information panel than a design viewer.
Can I use this to find out which of my project's files changed most recently?
Yes. Ask it to list the files in the project, then check the file details for the ones you care about.
Which apps does it work in?
It has been tested with Claude Desktop. Any app that can launch a local tool server with an absolute file path should work too.
How hard is the setup?
Hard for a non-developer. You install it, compile it, find the absolute path to the built file, create a Figma token and hand-edit a config file. Restarting the app is also required.
Does it cost anything?
The tool is free, and Figma's read access works on a free account. You do need the project's identifier, which you take from the Figma web address.