# grab/cursor-talk-to-figma-mcp architecture

> Architecture diagram of the GitHub repository grab/cursor-talk-to-figma-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/grab/cursor-talk-to-figma-mcp
- Repository: https://github.com/grab/cursor-talk-to-figma-mcp

## Overview

Talk to Figma MCP connects an AI agent to a running Figma plugin through a channel-based WebSocket relay. The principal workflow is: an agent invokes an MCP tool, the server sends a command through the relay, the plugin performs the design operation in Figma, and the response returns to the agent. The graph groups documented tool capabilities into domain stages. The README documents the overall connection; sampled excerpts show command dispatch and selected operations, so unsampled capability links rely on the README rather than claims of inspected implementation.

Main entry points: [`src/talk_to_figma_mcp/server.ts`](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/talk_to_figma_mcp/server.ts) (MCP server), [`src/cursor_mcp_plugin/code.js`](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js) (Plugin dispatcher), [`src/socket.ts`](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/socket.ts) (Channel relay)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent interface"]
  node_mcp["MCP server<br/>[server.ts]"]
end

subgraph group_bridge["WebSocket bridge"]
  node_relay["Channel relay<br/>[socket.ts]"]
  node_plugin["Plugin dispatcher<br/>[code.js]"]
end

subgraph group_figma["Figma operations"]
  node_figma_app["Figma document"]
end

subgraph group_domains["Design capabilities"]
  node_read["Document and selection<br/>[code.js]"]
  node_annotations["Annotations<br/>[code.js]"]
  node_prototypes["Prototype connections<br/>[code.js]"]
  node_create["Element creation<br/>[code.js]"]
  node_text["Text editing<br/>[code.js]"]
  node_layout["Auto layout<br/>[code.js]"]
  node_styling["Styling<br/>[code.js]"]
  node_organization["Layout and organization<br/>[code.js]"]
  node_components["Components and styles<br/>[code.js]"]
  node_export["Image export<br/>[code.js]"]
end

node_ai(("AI agent"))

node_ai -->|"invokes tools"| node_mcp
node_mcp -->|"sends commands"| node_relay
node_relay -->|"forwards messages"| node_plugin
node_plugin -->|"returns results"| node_relay
node_relay -->|"returns responses"| node_mcp
node_mcp -->|"requests reads"| node_read
node_mcp -->|"requests annotations"| node_annotations
node_mcp -->|"requests connections"| node_prototypes
node_mcp -->|"requests creation"| node_create
node_mcp -->|"requests text edits"| node_text
node_mcp -->|"requests layout changes"| node_layout
node_mcp -->|"requests style changes"| node_styling
node_mcp -->|"requests organization"| node_organization
node_mcp -->|"requests component work"| node_components
node_mcp -->|"requests exports"| node_export
node_plugin -->|"dispatches commands"| node_read
node_plugin -.->|"dispatches commands"| node_annotations
node_plugin -.->|"dispatches commands"| node_prototypes
node_plugin -->|"dispatches commands"| node_create
node_plugin -->|"dispatches commands"| node_text
node_plugin -.->|"dispatches commands"| node_layout
node_plugin -.->|"dispatches commands"| node_styling
node_plugin -.->|"dispatches commands"| node_organization
node_plugin -.->|"dispatches commands"| node_components
node_plugin -->|"dispatches commands"| node_export
node_read -->|"reads document"| node_figma_app
node_annotations -.->|"reads and updates"| node_figma_app
node_prototypes -.->|"reads and creates"| node_figma_app
node_create -->|"creates elements"| node_figma_app
node_text -->|"updates text"| node_figma_app
node_layout -.->|"changes layout"| node_figma_app
node_styling -.->|"changes styles"| node_figma_app
node_organization -.->|"organizes nodes"| node_figma_app
node_components -.->|"reads and updates"| node_figma_app
node_export -->|"exports image"| node_figma_app

click node_mcp "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/talk_to_figma_mcp/server.ts"
click node_relay "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/socket.ts"
click node_plugin "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_read "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_annotations "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_prototypes "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_create "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_text "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_layout "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_styling "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_organization "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_components "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"
click node_export "https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp toneBlue
class node_relay,node_plugin toneAmber
class node_figma_app toneMint
class node_read,node_annotations,node_prototypes,node_create,node_text,node_layout,node_styling,node_organization,node_components,node_export toneRose
class node_ai toneIndigo
```

## Components

### Agent interface

- [MCP server](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/talk_to_figma_mcp/server.ts): `src/talk_to_figma_mcp/server.ts`

### WebSocket bridge

- [Channel relay](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/socket.ts): `src/socket.ts`
- [Plugin dispatcher](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`

### Figma operations

- **Figma document**

### Design capabilities

- [Document and selection](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Annotations](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Prototype connections](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Element creation](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Text editing](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Auto layout](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Styling](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Layout and organization](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Components and styles](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`
- [Image export](https://github.com/grab/cursor-talk-to-figma-mcp/blob/main/src/cursor_mcp_plugin/code.js): `src/cursor_mcp_plugin/code.js`

### Other components

- **AI agent**

## Connections

- AI agent → MCP server: invokes tools (evidence: `README.md`)
- MCP server → Channel relay: sends commands (evidence: `README.md`)
- Channel relay → Plugin dispatcher: forwards messages (evidence: `README.md`)
- Plugin dispatcher → Channel relay: returns results (evidence: `README.md`)
- Channel relay → MCP server: returns responses (evidence: `README.md`)
- MCP server → Document and selection: requests reads (evidence: `src/talk_to_figma_mcp/server.ts`)
- MCP server → Annotations: requests annotations (evidence: `README.md`)
- MCP server → Prototype connections: requests connections (evidence: `README.md`)
- MCP server → Element creation: requests creation (evidence: `src/talk_to_figma_mcp/server.ts`)
- MCP server → Text editing: requests text edits (evidence: `src/talk_to_figma_mcp/server.ts`)
- MCP server → Auto layout: requests layout changes (evidence: `README.md`)
- MCP server → Styling: requests style changes (evidence: `README.md`)
- MCP server → Layout and organization: requests organization (evidence: `README.md`)
- MCP server → Components and styles: requests component work (evidence: `src/talk_to_figma_mcp/server.ts`)
- MCP server → Image export: requests exports (evidence: `src/talk_to_figma_mcp/server.ts`)
- Plugin dispatcher → Document and selection: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Annotations: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Prototype connections: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Element creation: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Text editing: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Auto layout: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Styling: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Layout and organization: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Components and styles: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Plugin dispatcher → Image export: dispatches commands (evidence: `src/cursor_mcp_plugin/code.js`)
- Document and selection → Figma document: reads document (evidence: `src/cursor_mcp_plugin/code.js`)
- Annotations → Figma document: reads and updates
- Prototype connections → Figma document: reads and creates
- Element creation → Figma document: creates elements (evidence: `README.md`)
- Text editing → Figma document: updates text (evidence: `src/cursor_mcp_plugin/code.js`)
- Auto layout → Figma document: changes layout
- Styling → Figma document: changes styles
- Layout and organization → Figma document: organizes nodes
- Components and styles → Figma document: reads and updates
- Image export → Figma document: exports image (evidence: `README.md`)
