This repository hosts a Model Context Protocol (MCP) server enabling integration with Figma's API through Claude, offering read-only access to Figma files and projects with potential for advanced design token management.
This project is a Model Context Protocol (MCP) server designed to integrate Figma's API with clients like Claude. It currently offers read-only access to Figma files and projects, with a server-side architecture prepared for advanced design token and theme management, pending further Figma API capabilities.
The core implementation, Claude Desktop integration, and read operations (get-file
, list-files
) are functional. The server architecture includes caching, error handling, and stats monitoring, supporting both stdio and SSE transport. Potential full functionality includes variable, reference, theme, and dependency management, plus batch operations, awaiting Figma API enhancements.
Key features include secure Figma API authentication, file operations (read, list), design system management (variable/theme creation), performance optimization (LRU caching, rate limit handling), and comprehensive monitoring (health checks, usage statistics).
Requires Node.js 18.x+, a Figma access token, and basic MCP knowledge. Installation is via npm install figma-mcp-server
. Configuration involves setting environment variables in a .env
file and configuring Claude Desktop with the server's absolute path.
Basic usage involves importing and starting the server. Available tools include get-file
, list-files
, create-variables
, and create-theme
. The API documentation details server methods and Zod schemas for tool input validation. Error handling provides detailed messages and codes.
TimHolden/figma-mcp-server
December 28, 2024
March 28, 2025
TypeScript