Skip to content

Snail.MCP.Figma

A local MCP server that gives an AI agent 139 tools for reading and editing Figma.

Reads go through the live Figma Desktop plugin — no REST quota spent and unsaved edits visible — or through the REST API behind a LiteDB snapshot cache and a sanitizer that keeps the raw Figma JSON out of the model context. Writes go through the plugin only: nodes, variables, components, FigJam and Slides.

flowchart LR
    C["MCP client"] -- stdio --> S["Snail.MCP.Figma"]
    S -- READ --> P["Live editor<br/>Figma Desktop plugin"]
    P -. no session .-> N["LiteDB snapshot"]
    N -. stale .-> R["Figma REST API"]
    R --> Z["Sanitizer"]
    S -- WRITE --> P
    P -- DOCUMENT_CHANGE --> I["Snapshot invalidator"]

Quick start

Install the server as a .NET tool (.NET 10 SDK required):

dotnet tool install -g Snail.MCP.Figma

Register the command with your MCP client:

{
  "mcpServers": {
    "snail-mcp-figma": {
      "command": "snail-mcp-figma",
      "env": {
        "SNAIL_MCP_FIGMA_ACCESS_TOKEN": "figd_..."
      }
    }
  }
}

Then import the bundled plugin into Figma Desktop once — Plugins → Development → Import plugin from manifest…, picking manifest.json from ~/.snail-mcp-figma/plugin — and run Snail Bridge in the file you work in.

The token is needed by the REST channel only — version history, comments, other teams' libraries and files that are not open in the desktop app. Everything else works through the plugin without a token.

Step-by-step instructions for every client, the token scopes, updating and uninstalling: Installation.

Where to go next

  • Installation — prerequisites, the three ways to install, client-by-client registration, verification.
  • Tools — all 139 tools with parameters and JSON schemas, generated from the server itself.
  • Architecture — the two channels, snapshots, the quota circuit breaker.
  • Configuration — environment variables and the optional settings file.
  • Plugin setup — installing the Figma Desktop bridge.
  • Troubleshooting — what to do when a tool answers "the plugin is not connected".

Licences

The server is MIT. The bundled plugin/ is MIT, Figma Console MCP Contributors (Southleft) — this project started as a C# port of figma-console-mcp.