Open your terminal, navigate to the folder where you want to install the tool, and run:
npx claude-talk-to-figma-mcp
π‘ Tip: This command is an "all-in-one" (clones, installs, and starts). In subsequent sessions, if you're already inside the project folder your-project/claude-talk-to-figma-mcp, you can simply run bun run socket.
Step 2: Install the plugin in Figma
Enables Figma to receive commands from the agent and return responses.
In Figma Desktop go to Menu β Plugins β Development β Import plugin from manifest β inside the folder where you installed the MCP, select src/claude_mcp_plugin/manifest.json
Step 3: Configure your Agentic Tool
Enables the agent to use the MCP's read and modify tools.
Claude Desktop
Download claude-talk-to-figma-mcp.dxt (from Assets section of the latest release) and double-click. Claude configures itself automatically.
Copy the channel ID (bold code inside the green box)
Type in the chat: Connect to Figma, channel {your-ID}
β Ready to design with AI!
Subsequent work sessions
To use the MCP again in day-to-day work, you don't need to repeat the entire process:
Start the socket: In the terminal, enter the project folder your-project/claude-talk-to-figma-mcp and run bun run socket (or npm run socket).
Open the plugin in Figma: You'll find it in your recent plugins list.
Connect the AI: Copy the channel ID and tell your agent: Connect to Figma, channel {your-ID}.
π€ Multi-Agent & Parallel execution
This MCP server supports safe parallel execution out of the box, allowing multiple AI agents (e.g. Claude Code's sub-agents or team swarms) to work simultaneously on your Figma file without locking up the plugin. A built-in command queue processes requests sequentially on the server side, preventing the Figma API from timing out.
Note: Because multiple agents can modify the document simultaneously, relying on implicit page context is unsafe. As a result, stateful commands like set_current_page are blocked. All agents must explicitly provide the intended parentId parameter when executing any creation or structural modification command (e.g., create_frame, create_text).
(Special thanks to @mmabas77 for architecting and contributing this feature!)
π³ Alternative: Using Docker
If you prefer Docker or need to run the WebSocket server in a team environment, see the Docker installation guide in the detailed installation documentation.
π οΈ Capabilities
Design analysis
Get document information, current selection, styles