Catalog My learning Blog
MCP Setup Guides: Cursor, Codex, Gemini CLI and Top Servers · Phase 2 · Lesson 12 · 4 min read

Figma MCP Server Setup: Remote vs Desktop

On this page
  1. Why not just paste a screenshot?
  2. Remote or desktop?
  3. Add the remote server
  4. Or enable the desktop server
  5. How to ask for a design
  6. The tools behind it
  7. Getting better code out of it
  8. Check yourself

Why not just paste a screenshot?

A screenshot tells the agent what a design looks like. It doesn't say that the gray is your color/surface/muted variable, that the spacing is 24 pixels, or that the button is already a component in your codebase. So the agent invents values, and you spend the next hour replacing them. Figma's MCP server sends that structure along with the picture, so the code uses your tokens and components.

Remote or desktop?

Figma runs two servers:

RemoteDesktop
URLhttps://mcp.figma.com/mcphttp://127.0.0.1:3845/mcp
Needs the Figma desktop appNoYes, running
PlansAll plansA Dev or Full seat on a paid plan (Professional, Education, Organization, Government or Enterprise)
How you point at a designPaste a link to a frameSelect it in Figma, or paste a link
Can write to the canvasYes (beta)No

Start with the remote server: it works on every plan and needs nothing installed. One limit to know: only clients listed in Figma's MCP catalog (figma.com/mcp-catalog) can connect to it. Claude Code, Codex, Cursor, VS Code and Gemini CLI are all on that list.

Add the remote server

You sign in with your Figma account the first time you connect.

Claude Code. Figma's docs list the plugin as the recommended route:

Code
claude plugin install figma@claude-plugins-official

Or add just the server:

Code
claude mcp add --transport http figma https://mcp.figma.com/mcp

Codex CLI:

Code
codex mcp add figma --url https://mcp.figma.com/mcp

Cursor (~/.cursor/mcp.json):

JSON
{
  "mcpServers": {
    "figma": { "url": "https://mcp.figma.com/mcp" }
  }
}

VS Code (.vscode/mcp.json):

JSON
{
  "servers": {
    "figma": { "type": "http", "url": "https://mcp.figma.com/mcp" }
  }
}

Or enable the desktop server

  1. Open a design file in the Figma desktop app.
  2. Switch to Dev Mode (press Shift+D) with nothing selected.
  3. In the right sidebar, find the MCP server section and click Enable desktop MCP server.

Then connect your client to the local URL, for example in Claude Code:

Code
claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp

How to ask for a design

With the remote server, give the agent a link. In Figma, right-click the frame or layer and choose Copy link to selection, then paste it into your prompt:

Code
Build this card as a React component using our existing Button and Avatar components:
https://www.figma.com/design/AbC123/Dashboard?node-id=42-1337

The client doesn't open the link in a browser. It pulls the node ID out of it and asks the server for that node. With the desktop server you can skip the link: select the frame in Figma and say "implement my current selection".

The tools behind it

The tool you'll see most is get_design_context. It returns the layer's structure and suggested code, React with Tailwind by default, which the agent then adapts to your stack. Others fill in the details:

  • get_variable_defs returns the variables and styles used, so colors and spacing map to your tokens.
  • get_screenshot gives the agent an image to check its result against.
  • get_metadata returns a lighter outline of a large selection, useful before drilling into one part.
  • get_code_connect_map links Figma components to the components in your codebase, if your team uses Code Connect.

The remote server also has write tools, such as generate_figma_design, which are free during the beta. Writing outside your drafts needs a Full seat.

Getting better code out of it

  • Select less. Ask for one card or section at a time, not a whole page. Use get_metadata to outline a big screen first, then request its parts.
  • Name your layers and use components and variables. The server can only pass on structure that exists in the file.
  • Tell the agent your stack, such as "Vue with our CSS modules", since the default output is React and Tailwind.
  • Generate project rules once with the create_design_system_rules prompt, so every later request follows your conventions.

Check yourself

The remote server at https://mcp.figma.com/mcp. The desktop server needs a Dev or Full seat on a paid plan.

Calling a Figma MCP tool such as get_design_context, using the node ID from the link. Check that the Figma server is connected and enabled in your client.

Make sure the design uses Figma variables, and have the agent call get_variable_defs (or ask it to map values to your tokens) along with get_design_context.