Skip to content

Figma MCPA local companion for Figma documents

Connect MCP clients to an open Figma document through a local, loopback-only bridge.

FigmaMCP connector mark

FigmaMCP — A local bridge between MCP and your Figma canvas

Overview ​

Figma MCP is a local companion for Figma documents with the Figma Bridge plugin open. An MCP client starts a .NET frontend and exchanges protocol messages with it over STDIO. Frontends share an automatically started backend per OS user and Bridge port; that backend owns Figma connections.

MCP clientMCP frontendShared backendConnection registryBridge pluginFigma APIStart and establish MCP over STDIODiscover or start backend; connect over private IPCOpen the loopback WebSocket using figma-mcp-bridge.v2Validate the hello message and register connection_idConfirm registration with hello_ackCall a document tool with the selected connection_idForward operation over private IPCResolve the live connection and allocate request_idReturn the active plugin connectionSend a bounded MessagePack bridge requestRead or mutate the active Figma documentReturn the operation resultSend the MessagePack response with request_idReturn operation resultReturn the matched MCP result over stdout

The companion separates transport ownership:

  • Frontend STDIO serves MCP. Protocol messages use stdin and stdout; diagnostics use stderr.
  • The shared backend loopback WebSocket endpoint at /bridge serves the Figma Bridge plugin.

The server, plugin, and bridge use explicit typed contracts. Document-specific MCP tools receive a live connection_id, and bridge operations use bounded payloads, a 30-second deadline, and idempotent mutation keys where applicable.

Install and connect ​

Install the companion and Bridge plugin, then connect your MCP client using the installation guide. The client starts its frontend over STDIO, and the plugin connects to the shared backend Bridge endpoint.

Documentation map ​

  • Architecture explains transports, lifecycle, state, and security boundaries.
  • Installation walks through installing the companion and connecting the plugin and MCP client.
  • Development describes the repository layout, build commands, and local checks.
  • Tool reference defines the MCP tool contract.
  • Plugin API coverage records supported and deferred Figma API areas.

Documentation for Figma MCP v2.0.0. Released under the MIT License.