🎨 Figma MCP for Free Plan

https://smithery.ai/servers/haju-xp/figma-free-mcp

Connect Claude to Figma with zero friction. No paid plan. No channel ID copy-paste. Just works.

✨ Why this exists

Related MCP server: Claude Talk to Figma MCP

🚀 Quick Start (4 steps)

Step 1 — Install MCP + download plugin

npx figma-free-mcp@latest setup

This will:

• ✅ Register MCP in Claude Desktop automatically

• ✅ Download the Figma plugin to ~/.figma-free-mcp/plugin/

• ✅ Show you the exact manifest path

Step 2 — Install the Figma plugin (one-time)

1. Open Figma Desktop

2. Menu → Plugins → Development → Import plugin from manifest...

3. Select the path shown in Step 1:

   C:\Users\[YourName]\.figma-free-mcp\plugin\manifest.json

This will:

• ✅ Register the Figma plugin in your Figma Desktop

Step 3 — Start the relay server

figma-free-mcp socket

This will:

• ✅ Start the WebSocket relay server between Claude and Figma

• ✅ Keep the connection alive while you work

⚠️ Must run this BEFORE opening the Figma plugin. Keep this terminal open while using Claude with Figma.

Step 4 — Open the Figma plugin

1. Open your Figma file

2. Menu → Plugins → Figma Free MCP

This will:

• ✅ Auto-connect to the relay server

• ✅ No channel ID needed

💬 Usage

Once everything is running, just talk to Claude naturally:

"Figma에 버튼 컴포넌트 만들어줘"
"중복 페이지 찾아서 정리해줘"
"globals.css 색상 토큰을 Figma 변수로 싱크해줘"
"이 React 컴포넌트를 Figma 프레임으로 변환해줘"

Claude automatically detects your open Figma file — no channel ID needed!

🗂️ Working with Multiple Files (Concurrent Editing)

Edit several Figma files in one session — still no channel IDs, just file names.

Setup: open each file and run the plugin in it (one plugin instance per file — a Figma limitation: a plugin can only touch the file it runs in).

"어떤 Figma 파일들이 열려 있어?"          → list_active_channels (shows file & page names)
"미들마일 주문 파일에 버튼 만들어줘"        → connect_to_file then edit, or run_on_file
"미들마일엔 헤더, 정산관리엔 합계 텍스트 넣어줘"  → runs on both files concurrently

⚠️ Each file you want to edit must have its own running plugin instance. A file that's only open in the background (no plugin) cannot be edited.

🛠️ All Tools (100+)

🔌 Auto-Connect & Multi-File

📄 Document & Pages

get_document_info, get_pages, get_selection, get_node_info, get_nodes_info, scan_text_nodes, get_styles, get_local_components, get_remote_components, get_variables and more

🖼️ Creation

create_frame, create_rectangle, create_ellipse, create_text, create_page, create_component_from_node, create_component_instance, create_component_set and more

✏️ Modification

set_fill_color, set_stroke_color, set_text_content, set_font_size, set_corner_radius, set_auto_layout, move_node, resize_node, delete_node, clone_node and more

🎨 Design System Sync

📋 Page Manager

⚡ Code to Figma

🏗️ Architecture

Claude Desktop
    │
    │ stdio (MCP)
    ▼
figma-free-mcp server (100+ tools)
    │
    │ WebSocket (port 3055)
    ▼
Figma Plugin (auto-connect)
    │
    │ Figma API
    ▼
Your Figma File ✨

⚙️ Commands Reference

# Install & register MCP
npx figma-free-mcp@latest setup

# Start WebSocket relay server
figma-free-mcp socket

# Uninstall
npx figma-free-mcp@latest uninstall

🔄 Upgrading from v1.0.7 or earlier

─────────────────────────────

If you see a recurring "MCP figma-free-mcp-socket: Server disconnected" error in Claude Desktop, run this once:

npx figma-free-mcp@latest setup

Then restart Claude Desktop. The error will be gone.

─────────────────────────────

❓ FAQ

Q. Do I need a paid Figma plan? A. No. Works with free Figma accounts.

Q. Do I need Claude Pro? A. Any Claude Desktop plan works.

Q. The plugin shows "Disconnected" A. Make sure the relay server is running: figma-free-mcp socket

Q. Multiple Figma files are open A. list_active_channels shows each session with its file & page name. Use connect_to_file("name") to focus one, or run_on_file("name", ...) to edit several files concurrently — no channel IDs needed. Each file must have its own running plugin instance.

Q. Port 3055 is already in use A. Kill the existing process: netstat -ano | findstr :3055 then taskkill /PID [number] /F

⚠️ License & Usage

MIT License — free to use and modify.

✅ Personal & commercial use allowed ✅ Modification allowed ❌ Claiming as your own work prohibited ❌ Removing author credit prohibited

© 2026 haju-xp

🙏 Credits

Built on top of claude-talk-to-figma-mcp by arinspunk (MIT License).