mcp-figma
A Model Context Protocol (MCP) server for Figma API integration, designed to be used with Claude and other MCP-compatible AI assistants.
Features
This MCP server provides access to Figma API functionality:
- File operations (get file, get nodes, get images)
- Comments management
- Team/project management
- Components and styles access
- Persistent API key storage
Installation
NPM Installation
# Install globally
npm install -g mcp-figma
# Or install locally in a project
npm install mcp-figma
# Update to latest version
npm update -g mcp-figma
Usage with Claude
- Add mcp-figma to your Claude configuration:
"mcp-figma": {
"command": "npx",
"args": [
"-y",
"mcp-figma"
]
}
- When using Claude, the first time you'll need to set your Figma API key:
Please use mcp-figma to set my Figma API key: figd_xxxxxxxxxxxxxxxxxxxxxxx
Your API key will be stored in ~/.mcp-figma/config.json and will be automatically loaded in future sessions.
- You can verify your API key is configured:
Please use mcp-figma to check my API key status
- Then use any of the available Figma API functions:
Please use mcp-figma to get the file with key abc123
Available Tools
The server provides the following tools:
set_api_key: Set your Figma API personal access token (saved to config)check_api_key: Check if an API key is already configuredget_file: Get a Figma file by keyget_file_nodes: Get specific nodes from a Figma fileget_image: Get images for nodes in a Figma fileget_image_fills: Get URLs for images used in a Figma fileget_comments: Get comments on a Figma filepost_comment: Post a comment on a Figma filedelete_comment: Delete a comment from a Figma fileget_team_projects: Get projects for a teamget_project_files: Get files for a projectget_team_components: Get components for a teamget_file_components: Get components from a fileget_component: Get a component by keyget_team_component_sets: Get component sets for a teamget_team_styles: Get styles for a teamget_file_styles: Get styles from a fileget_style: Get a style by key
For detailed usage examples, see USAGE.md.
License
MIT