gethopp/figma-mcp-bridge

Demo
Quick Start
Available Tools
Local development
Structure
How it works
> [!NOTE]
> Requires the Figma desktop app (macOS/Windows). The browser version of Figma does not support importing development plugins.
While other amazing Figma MCP servers like Figma-Context-MCP exist, one issues is the API limiting for free users.
The limit for free accounts is 6 requests per month, yes per month.
Figma MCP Bridge is a solution to this problem. It is a plugin + MCP server that streams live Figma document data to AI tools without hitting Figma API rate limits, so its Figma MCP for the rest of us ✊
It supports multiple Figma files connected simultaneously; open the plugin in each file and your AI agent can query any of them by fileKey. Single-file setups work exactly as before with no changes required.
It also includes a small, opt-in set of write tools for safe agent-driven edits — see Editing Notes below.
## Demo
Watch a demo of building a UI in Cursor with Figma MCP Bridge
## Quick Start
### 1. Add the MCP server to your favourite AI tool
Add the following to your AI tool's MCP configuration (e.g. Cursor, Windsurf, Claude Desktop):
json
"figma-bridge": {
"command": "npx",
"args": ["-y", "@gethopp/figma-mcp-bridge"]
That's it — no binaries to download or install.
### 2. Add the Figma plugin
Download the plugin from the latest release page, then in Figma go to Plugins > Development > Import plugin from manifest and select the manifest.json file from the plugin/ folder. The same plugin runs in Figma design files, Dev Mode (read-only), and FigJam boards.
### 3. Start using it 🎉
Open a Figma file, run the plugin, and start prompting your AI tool. The MCP server will automatically connect to the plugin.
To work across multiple files, just open the plugin in each Figma file. The bridge keeps all connections active and your AI agent can target any of them by fileKey.
If you want to know more about how it works, read the How it works section.
## Available Tools
| Tool | Description |
| listfiles | List all connected Figma files (supports multi-file workflows) |
| getdocument | Get the current Figma page document tree |
| getselection | Get the currently selected nodes in Figma |
| getnode | Get a specific Figma node by ID (colon format, e.g. 4029:12345) |
| getprototypeconnections | Read prototype interactions on a node and its descendants |
| traceprototypeflow | Trace prototype navigation between screens |
| getstyles | Get all local paint, text, effect, and grid styles |
| getmetadata | Get file name, pages, and current page info |
| getdesigncontext | Get a depth-limited tree optimized for understanding design context |
| getvariabledefs | Get all variable collections, modes, and values (design tokens) |
| getscreenshot | Export nodes as PNG/SVG/JPG/PDF (base64-encoded) |
| savescreenshots | Export and save screenshots directly to the local filesystem |
| getmotionstyles | List all available animation presets (beta) |
| getnodemotion | Read a node's current animation styles and properties (beta) |
| applyanimationstyle | Apply a preset animation style to a node (beta) |
| removeanimationstyle | Remove an applied animation style from a node (beta) |