Figma MCP Tool
Provides tools for exporting images in multiple formats (PNG, JPG, SVG, PDF), extracting detailed style data with CSS generation, analyzing design elements including images and vectors, batch exporting multiple nodes, and retrieving SVG code for vector graphics directly from Figma designs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Figma MCP Tool export the hero section from this Figma design as PNG"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Figma MCP Tool
English | 简体中文
A Model Context Protocol (MCP) server that integrates with the Figma API to export images and extract style data.
Features
🖼️ Image export: Export node images from a Figma URL; supports PNG, JPG, SVG, PDF
🎨 Style extraction: Fetch detailed style data for design elements; supports CSS generation
📦 Batch export: Export multiple nodes in one go
🔄 Smart retry: Built-in retry to handle network hiccups and API limits
🛡️ Robust errors: Clear error handling and troubleshooting guidance
🧩 Design element analysis: Deeply analyze images, vectors, components in designs 🆕
📋 SVG extraction: Get SVG code for vector graphics directly 🆕
Related MCP server: Figma MCP
Install and Run
Option 1: Run via npx (recommended, no install)
npx figma-mcp-full-server figd_your_figma_token_hereOption 2: Global install
# Install globally
npm install -g figma-mcp-full-server
# Run
figma-mcp-full-server figd_your_figma_token_hereOption 3: Local project install
# Install in your project
npm install figma-mcp-full-server
# Run
npx figma-mcp-full-server figd_your_figma_token_here
# or
node_modules/.bin/figma-mcp-full-server figd_your_figma_token_hereOption 4: Run from source (for development)
git clone <repository>
cd figma-mcp
npm install
npm run build
# Run
npm start figd_your_figma_token_here
# or
node build/index.js figd_your_figma_token_hereQuick Start
1. Get a Figma access token
Log in to Figma
Open Settings
Find the "Personal access tokens" section
Click "Create new token"
Copy the token (starts with
figd_)
2. Configure in Claude Desktop
Edit the Claude config file (pick your OS):
macOS/Linux: ~/.config/claude-desktop/config.json
Windows: %APPDATA%\Claude Desktop\config.json
Choose one of the following setups:
Setup A: Run via npx (recommended)
{
"mcpServers": {
"figma-mcp-full-server": {
"command": "npx",
"args": ["figma-mcp-full-server"],
"env": {
"FIGMA_TOKEN": "figd_your_figma_token_here"
}
}
}
}Setup B: Global install
npm install -g figma-mcp-full-server{
"mcpServers": {
"figma-mcp-full-server": {
"command": "figma-mcp-full-server",
"env": {
"FIGMA_TOKEN": "figd_your_figma_token_here"
}
}
}
}Setup C: Use from a project
npm install figma-mcp-full-server{
"mcpServers": {
"figma-mcp-full-server": {
"command": "npx",
"args": ["figma-mcp-full-server"],
"cwd": "/path/to/your/project",
"env": {
"FIGMA_TOKEN": "figd_your_figma_token_here"
}
}
}
}Setup D: Run from source
{
"mcpServers": {
"figma-mcp": {
"command": "node",
"args": [
"/absolute/path/to/figma-mcp/build/index.js"
],
"cwd": "/absolute/path/to/figma-mcp",
"env": {
"FIGMA_TOKEN": "figd_your_figma_token_here"
}
}
}
}⚠️ Notes:
Recommended: Setup A (npx) — no install, always latest
Global install: good if you use it often
Project install: pin a version per project
From source: for development and customization
Replace
figd_your_figma_token_herewith your real Figma token
3. Restart Claude Desktop
Restart Claude Desktop to apply the config.
Usage
Once configured, use it directly in Claude:
Get Figma images
Please fetch images from this Figma URL:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-Name?node-id=123-456&t=abc123-0Get style data and generate CSS
Please get style data from this design and generate CSS:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-Name?node-id=123-456&t=abc123-0Get file info
Please show the basic info for this Figma file:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-NameGet design elements 🆕
Please analyze what design elements this Figma node contains:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-Name?node-id=123-456&t=abc123-0Get image assets 🆕
Please extract all image assets under this Figma node:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-Name?node-id=123-456&t=abc123-0Get SVG data 🆕
Please get the SVG code for this Figma node:
https://www.figma.com/design/EXAMPLE_FILE_ID/Design-Name?node-id=123-456&t=abc123-0Available Tools
This MCP server provides 7 tools:
Basics
get_figma_image — Get node image by Figma URL
get_figma_styles — Get node style data; optional CSS output
export_multiple_images — Batch export multiple nodes
get_file_info — Get basic file info
Design element tools 🆕
get_node_images — Get all image assets under a node
get_node_svg — Get SVG data for a node
extract_node_elements — Extract all design elements (images, vectors, components)
Troubleshooting
Common issues
1. "Cannot find module"
Cause: Using a
.tsentry instead of the built.jsFix: Use
/path/to/build/index.jsinstead ofindex.ts
2. "Access denied"
Cause: Invalid Figma token or insufficient file permission
Fix: Verify token, ensure file is public or accessible
3. MCP server won’t start
Cause: Wrong paths or Node.js version too low
Fix:
Use absolute paths
Ensure Node.js ≥ 18
Rebuild:
npm run build
4. "No exportable images found"
Cause: URL missing
node-idparameterFix: Ensure URL includes
?node-id=xxxxx-xxxxx
Manual test
cd /path/to/figma-mcp
node build/index.js figd_your_token_hereYou should see: Figma MCP server started
Validate config
# macOS/Linux
cat ~/.config/claude-desktop/config.json | python -m json.tool
# Windows
type "%APPDATA%\Claude Desktop\config.json" | python -m json.toolTechnical Details
Smart retry
Handles transient network issues automatically
Exponential backoff
Error classification and recovery
Batch processing
Automatically splits large node sets (90 per batch)
Avoids URL length limits
Concurrency control and resource management
Error handling
Detailed messages and remediation tips
Friendly feedback
Complete logging
Development
Dev mode
npm run dev
# Then set FIGMA_TOKEN in your environmentProject structure
figma-mcp/
├── src/
│ ├── index.ts # MCP server entry
│ ├── figma-service.ts # Figma API service
│ ├── image-extractor.ts # Image export
│ ├── style-extractor.ts # Style extraction
│ └── element-extractor.ts # Design element extraction 🆕
├── build/ # Build output
├── package.json
└── README.mdNew Features 🆕
Design element analysis
Image asset recognition: Find all images, including embedded and external
Vector extraction: Extract SVG paths, shapes, icons
Component analysis: Identify components and instances
Hierarchy traversal: Deeply walk the node tree
SVG data
Full SVG export: Complete SVG code with styles and paths
Vector fidelity: Preserve vector properties for lossless scaling
Inline styles: SVG contains complete styles, ready to use
Smart element detection
Auto categorization: Images, vectors, text, components
De-duplication: Remove duplicate resource references
Detail control: Overview vs detailed output modes
Security Best Practices
Token safety: Use env vars for the Figma token; never hardcode
Access control: Rotate tokens regularly
Least privilege: Grant the minimum required file access
License
MIT License
Support
If you run into issues:
Ensure Node.js ≥ 18
Verify your Figma token
Validate your JSON config
Check Claude Desktop logs
Manually start the MCP server
Once configured, you can use Figma files directly in Claude!
Contact
Available Tools
7 toolsexport_multiple_imagesC
批量导出多个节点的图片
Inputs: fileId (required), nodeIds (required), format, scale.
extract_node_elementsC
提取节点中的所有设计元素(图片、矢量、组件)
Inputs: url (required), includeDetails.
get_figma_imageC
根据Figma URL获取节点的图片
Inputs: url (required), format, scale.
get_figma_stylesC
根据Figma URL获取节点的样式数据
Inputs: url (required), generateCSS.
get_file_infoC
获取Figma文件的基本信息
Inputs: url (required).
get_node_imagesC
获取节点中的所有图片资源
Inputs: url (required).
get_node_svgC
获取节点的SVG数据
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have distinct purposes, but there is some overlap between 'export_multiple_images' and 'get_node_images' that could cause confusion. The descriptions help differentiate them, but the boundaries are not perfectly clear.
The naming follows a consistent verb_noun pattern with minor deviations, such as 'export_multiple_images' using an adjective. Overall, the pattern is readable and predictable across the tool set.
With 7 tools, the count is well-scoped for a Figma integration server. Each tool appears to serve a specific purpose related to extracting or retrieving design assets and data.
The tool set covers key operations for accessing Figma assets and styles, but there are minor gaps such as updating or modifying nodes. Agents can likely work around these limitations for most common workflows.
Maintenance
Related MCP Connectors
The Figma MCP server brings Figma design context directly into your AI workflow.
Turn any live website into brand colors, fonts, design tokens, SVGs, Lottie and paste-ready code.
Deterministic Figma to Elementor, Gutenberg, Oxygen, Etch and HTML layouts for AI assistants.
Split images into editable layers (PSD/PNG), outpaint images, and generate clean vector SVGs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Figma designs using natural language commands, supporting file analysis, component extraction, asset export, comment management, and design system queries through the Figma API.1ISC
- AlicenseAqualityDmaintenanceEnables interaction with Figma files through intelligent API access, providing navigation, asset extraction, and design token retrieval with 95% token-optimized compact tree output format.151MIT
- FlicenseBqualityDmaintenanceEnables AI agents to read, inspect, and export Figma designs programmatically. Provides tools for listing components, styles, and exporting assets in various formats.51-
- AlicenseNot gradedqualityDmaintenanceEnables developers to extract and organize Figma design files, including complete node data (tree structure and images) for AI understanding and code generation.MIT