Skip to main content
Glama

Figma MCP Python

PyPI version

Allow your AI coding agents to access Figma files & prototypes directly. You can DM me for any issues / improvements: https://x.com/jasonzhou1993

Quick Installation with pipx

pipx install figma-mcp

For Cursor:

  1. In settings, add an MCP server using the command:

figma-mcp --figma-api-key=your_figma_key
  1. OR Add a .cursor/mcp.json file in your project:

{
  "mcpServers": {
    "figma-python": {
      "command": "figma-mcp",
      "args": [
        "--figma-api-key=your_figma_key"
      ]
    } 
  }
}

For other IDEs like Windsurf, use an MCP configuration file (e.g., mcp_config.json):

{
  "mcpServers": {
    "figma-python": {
      "command": "figma-mcp",
      "args": [
        "--figma-api-key=your_figma_key"
      ]
    } 
  }
}

Related MCP server: figma-developer-mcp

Install uv and set up the environment

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv sync

Test locally

python -m figma_mcp.main

Available Tools

3 tools
get_componentsB

Get components available in a Figma file

    Args:
        file_key (str): The file key found in the shared Figma URL

    Returns:
        list[dict]: List of components found in the Figma file
    

Inputs: file_key (required).

get_nodeA

Get a specific node from a Figma file

    Args:
        file_key (str): The file key found in the shared Figma URL, e.g. if url is https://www.figma.com/proto/do4pJqHwNwH1nBrrscu6Ld/Untitled?page-id=0%3A1&node-id=0-3&viewport=361%2C361%2C0.08&t=9SVttILbgMlPWuL0-1&scaling=min-zoom&content-scaling=fixed&starting-point-node-id=0%3A3, then the file key is do4pJqHwNwH1nBrrscu6Ld
        node_id (str): The ID of the node to retrieve, has to be in format x:x, e.g. in url it will be like 0-3, but it should be 0:3

    Returns:
        dict: The node data if found, empty dict if not found
    

Inputs: node_id (required), file_key (required).

get_workflowB

Get workflows available in a Figma file

    Args:
        file_key (str): The file key found in the shared Figma URL, e.g. if url is https://www.figma.com/proto/do4pJqHwNwH1nBrrscu6Ld/Untitled?page-id=0%3A1&node-id=0-3&viewport=361%2C361%2C0.08&t=9SVttILbgMlPWuL0-1&scaling=min-zoom&content-scaling=fixed&starting-point-node-id=0%3A3, then the file key is do4pJqHwNwH1nBrrscu6Ld

    Returns:
        list[dict]: List of workflow connections found in the Figma file
    

Inputs: file_key (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct Figma element: components, nodes, and workflows. There is no overlap in their purposes, making it easy for an agent to select the correct tool.

    Naming Consistency5/5

    All tools follow a consistent 'get_' + singular noun pattern (get_components, get_node, get_workflow), which is predictable and easy to follow.

    Tool Count5/5

    With 3 tools, the server is tightly scoped for retrieving key Figma file elements. This number is appropriate for a focused MCP server without being too sparse or excessive.

    Completeness4/5

    The tools cover retrieval of components, nodes, and workflows, which are important aspects of a Figma file. However, it lacks tools for pages or styles, which are common use cases, so minor gaps exist.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables coding agents like Cursor to access Figma design data, fetch layout and styling information, and implement designs in any framework.
      145,772 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to extract design systems, analyze components, and maintain design-code consistency from Figma files, providing intelligent component analysis and accessibility compliance.
      42 npm
      27
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI coding agents to access Figma files and prototypes, allowing them to retrieve design data and assets directly.
      MIT