figma-mcp-server

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.

130
13

Figma MCP Server

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.

Project Status

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.

Features

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

Prerequisites & Installation

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.

Usage & API

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.

Repository

TI
TimHolden

TimHolden/figma-mcp-server

Created

December 28, 2024

Updated

March 28, 2025

Language

TypeScript

Category

Developer Tools