Back to Blog

How to Install and Set Up the Figma MCP Server

Sidra Arif
MCPModel Context ProtocolFigma MCP ServerFigma MCP

How to Install and Set Up the Figma MCP Server

The model context protocol (MCP) is transforming AI workflows by enabling AI agents and LLMS to connect to external tools and data sources. It makes AI agents smarter, allowing them to perform tasks beyond mere text generation. One of the examples of how we can use MCP for more intelligent workflows is by using Figma MCP servers.

Before MCP, we typically had to provide a screenshot or image of the design to an LLM or AI chatbot to convert the design into front-end code. However, this approach usually produced inaccurate and limited results as the context wasn’t rich enough for the chatbot to fully understand the design's intent or structure.

Thankfully, MCP has changed this. Today, we have Figma MCP servers that we can integrate with MCP clients (AI-powered apps) like Claude or Cursor, enabling them to convert Figma designs into more accurate front-end code.

Understanding Figma MCP Server

Figma is developing an official MCP server that is currently in public beta. Once mature, this server will provide the most standard-compliant solution for developers working with Figma’s API and MCP-based tools.

Fortunately, we also have multiple community-run Figma MCP servers used by many developers and designers worldwide:

Currently, one of the most popular Figma MCP servers is the Framelink Figma MCP Server with over 8k stars on GitHub. This server gives Cursor (an AI-powered code editor) access to Figma files and metadata like frames, layers, and components, enabling it to inspect the structure of files and gather context about design.

We can also use this server to implement design changes through natural language commands (in Cursor’s “agent” mode) without manually navigating Figma's interface.

In this article, we’ll provide a step-by-step guide for installing and setting up this MCP server in Cursor.

Explore more MCP servers for designers here.

Here, I’ll be using the Ubuntu WSL (Windows Subsystem for Linux) as Cursor v0.50.4 and above supports remote workspace stdio, such as WSL and SSH. This means these versions of Cursor can handle MCP servers running inside WSL directly without using cmd /c.

When using the Figma MCP server with Cursor through Windows Terminal or PowerShell, Cursor sometimes doesn’t detect tools. So, it’s best to use Ubuntu WSL.

Let’s get started (make sure you have node installed on your system).

Creating a Project Folder

Open Ubuntu WSL and run the following commands:

cd \~

mkdir \-p mcp-server

cd mcp-server

Getting Your Figma API Token

To use this server, we need a Figma API token. First, sign up for Figma. Once you have your Figma account, here’s how you can get your token:

Click on your account icon on the left sidebar and select settings:

Getting your Figma API Token

Then, go to the settings tab and select “Generate new token”:

Getting your Figma API Token

Select a name for your token, provide ‘read-only’ access for all fields, and click “Generate token”:

Getting your Figma API Token

Figma will then generate a personal token for you:

Getting your Figma API Token

As you can see in the above image, Figma only shows this token once. Copy it and save it somewhere to use later for the MCP server implementation.

Installing the MCP Server

First, install the server globally on your system:

npm install -g figma-developer-mcp

Then run the following command:

figma-developer-mcp --stdio --figma-api-key=YOUR_FIGMA_TOKEN

This command will start the Figma MCP server and authenticate it with your Figma account using your API key.

Note: Replace the token with your actual Figma token that you generated in the previous step.

Connecting the Server to Cursor

Now that our server is running, we can connect it to Cursor. Since we’re using Ubuntu WSL, we need to use Cursor's WSL remote integration. Here’s how to do it:

In the bottom left corner in Cursor, you’ll see a small sign for opening a remote window:

Cursor WSL Setup

When you click it, it’ll show you the option to connect to WSL:

Cursor WSL Setup

Now, select your project folder:

Cursor WSL Setup

Next, we’ll add our MCP server configuration in Cursor. To do so, go to Cursor settings and click “Tools and Integrations”. Then, select ‘Add a custom MCP server’:

Configuring the Figma MCP server in Cursor

Now, add the following code to the Cursor mcp.json file:

{
  "mcpServers": {
    "Figma Context MCP": {
      "command": "npx",
      "args": [
        "-y",
        "figma-developer-mcp",
        "--stdio",
        "--figma-api-key=YOUR_FIGMA_KEY"
      ]
    }
  }
}

Note: Replace ‘YOUR_FIGMA_KEY’ with your actual Figma API token.

We don’t need to add cmd /c or any wrappers because Cursor v0.50.4 and above handles WSL stdio automatically.

Once you add the above code to the mcp.json file, save it and go to Cursor settings again. You’ll now see your MCP server with tools:

Connecting the Figma MCP server to Cursor

If, after adding the code, Cursor keeps showing loading tools, simply disable the server and enable it again.

Now, go to your Figma account and choose a design. For demo purposes, we have taken a free template:

Example Figma file to use in Cursor with Figma MCP server

Click on the main frame, and select ‘copy link to selection’:

Copying link of Figma file to use in Cursor with Figma MCP server

Now, go to Cursor and paste this link in the ‘Agent’ interface and provide a prompt like ‘Implement this Figma design’:

Using the Figma MCP server in Cursor

Curson will then call the get_figma_data tool from the Figma MCP server and ask for your permission to run the tool:

Using the Figma MCP server in Cursor

Cursor will then provide you with steps to implement the design:

Using the Figma MCP server in Cursor

You can then ask Cursor to provide the complete project, and it will generate all the required files/code for you automatically:

Using the Figma MCP server in Cursor

You can then replace the placeholder images with your actual images and simply build your project. Notice how easy the Figma MCP server has made it to implement a Figma design.

Conclusion

The Framelink Figma MCP server has made it easier to provide detailed design context to AI models (specifically Cursor) and generate accurate code for it. Before MCP, we needed to provide a screenshot of the design to the AI model, which often produced inaccurate results.

In this article, we’ve provided a detailed step-by-step guide for implementing the Framelink Figma MCP server in Cursor.