What is UnityFigmaMCP?
UnityFigmaMCP is an MCP server with a matching Unity package that reads Figma nodes and builds prefabs inside a live Unity Editor session. It needs Unity 2021.3 or later and the .NET 8 SDK. Six bundled skills cover building, updating and diffing a prefab against Figma, plus binding an existing UI kit's components instead of generating new placeholders.
UnityFigmaMCP reads a Figma file through its own tools, then talks to a running Unity Editor to assemble a prefab: layout, text, images, components and variants, without hand-wiring each piece.
It ships two halves: an MCP server that fetches Figma data and drives the build, and a Unity package that runs inside the Editor and does the actual prefab construction.
What you can ask it to do
- Read a Figma node, its children and its component key, then export an image of it for reference.
- Build a new prefab from that node with a configurable layout pipeline, or edit and save an existing one.
- Import and save sprites from Figma exports, then bind them to the matching assets already in your Unity project.
- Check the connection and Figma token status, and compare a built prefab against its Figma source for drift.
What it needs to run
| UnityFigmaMCP | |
|---|---|
| Unity | 2021.3 or later |
| Runtime | .NET 8 SDK |
| Agent | Any MCP-compatible agent, Claude Code, Cursor or Windsurf among them |
| Figma | A valid Figma access token |
Who it is for
Best for
- Game UI developers who want a first-pass prefab built straight from a Figma screen instead of placing every element by hand.
- Teams with an existing UI kit who bind Figma components to real assets instead of letting the tool generate placeholders.
- Workflows that need to catch drift between a shipped prefab and a Figma source that kept changing.
Not for
- If the target is a React, Flutter or SwiftUI spec rather than a Unity prefab, Figma Spec MCP turns those same Figma frames into that platform spec instead.
- When the task is drawing on the Figma canvas directly rather than building a Unity prefab, Figma UI MCP can draw and read that Figma design instead.
- If the output should be web UI built from the same Figma file rather than a Unity prefab, Build Design Skill builds that UI from Figma directly.
- When what an agent needs first is Figma component and variable literacy rather than a Unity build, Figma Expert Skill covers those components and variables.
Use it with UiChemy
UnityFigmaMCP builds a prefab inside a game engine, not a web page. For the same Figma source turned into an editable WordPress build instead, UiChemy Figma to WordPress and Composer cover that path. Click Get Started on uichemy.com.
Connect UnityFigmaMCP: Build Unity Prefabs From Figma Designs to your AI client
git clone https://github.com/chav0/UnityFigmaMCP.gitClone the repository
Run
git clone https://github.com/chav0/UnityFigmaMCP.git. A direct clone is the documented path, with no packaged installer.Import the Unity package
Open your Unity 2021.3 or later project and import UnityFigmaMCPPackage so the Editor can receive build and edit requests.
Configure the MCP server
Add the config block above to your agent's MCP settings, for example ~/.claude.json for Claude Code, with your Figma access token set as an environment variable.
Check the connection
Call the status tool first to confirm the Figma token and the Unity Editor connection are both working before building a prefab.
Try the build-prefab skill
Use the bundled /build-prefab skill against a Figma node to run the full pipeline with a preview before committing to variants.
Client configuration
{
"mcpServers": {
"unity-figma": {
"command": "dotnet",
"args": ["/absolute/path/to/UnityFigmaMCPServer/UnityFigmaMCPServer.dll"],
"env": { "FIGMA_TOKEN": "your-figma-token" }
}
}
}Endpoints and ports
git clone https://github.com/chav0/UnityFigmaMCP.gitGets both the MCP server and the Unity package source.statusMCP tool that verifies the Figma token, Unity connection and server health.What you can do with it
- Live Unity Editor connectionThe MCP server talks to a running Unity Editor session directly, so a prefab gets built or edited in the same project you are already working in.
- 13 tools across four groupsFigma reading, prefab building, prefab editing and asset management each get their own small set of typed tools.
- Six bundled skillsbuild-prefab, update-prefab, download-sprites, bind-figma-unity, inspect-diff and setup-project cover the common workflows without writing a custom prompt each time.
- Asset binding over placeholdersBinding Figma components to assets already in your UI kit avoids the missing references and placeholder generation that happen when binding is skipped.
- Drift detectioninspect-diff compares a built prefab against its Figma source, useful when a design keeps changing after the first build.
- Configurable layout pipelinesunity_get_pipelines lists layout options so unity_build_prefab does not fail from missing pipeline configuration.
Tools it exposes
Figma tools
figma_get_node, figma_get_node_names, figma_get_component_info and figma_export_image retrieve design data, hierarchy, component keys and exported images.
Build tools
unity_build_prefab and unity_get_pipelines construct a prefab from Figma nodes with a configurable layout pipeline.
Edit tools
unity_edit_prefab, unity_save_prefab and unity_get_hierarchy modify and inspect an existing prefab.
Asset tools
unity_save_sprites, unity_bind and unity_list_assets manage sprite imports and link them to existing project assets.
Status tool
status verifies the Figma token, the Unity Editor connection and overall server health in one call.
Frequently asked questions
What is UnityFigmaMCP?
It is an MCP server paired with a Unity package that reads a Figma file and builds a Unity prefab, with layout, text, images, components and variants, by talking to a running Unity Editor session over 13 tools.
How do I install UnityFigmaMCP?
Clone the repository, import UnityFigmaMCPPackage into a Unity 2021.3 or later project, then point your agent's MCP config at the UnityFigmaMCPServer build with a valid Figma access token set as an environment variable.
What does the status tool check?
It verifies the Figma access token, confirms the Unity Editor connection is live, and reports overall server health, which is the first thing worth calling before attempting any prefab build at all.
What happens if I skip asset binding?
The project states plainly that skipping asset binding results in missing references and placeholder generation, instead of reusing the real components that already exist in your UI kit and project.
Can it update a prefab after the Figma design changes?
Yes. The update-prefab skill syncs an existing prefab with Figma changes, and inspect-diff compares a built prefab against its current Figma source to show exactly what drifted since the last build ran.
What Unity and .NET versions does it need?
Unity 2021.3 or later, and the .NET 8 SDK for the MCP server side. Without a configured layout pipeline, the unity_build_prefab tool fails outright rather than guessing at a default layout to use.
Does UnityFigmaMCP work with agents other than Claude?
Yes. The README lists Claude Code, Cursor and Windsurf as compatible, and describes the requirement simply as any MCP-compatible AI agent, since the server speaks standard MCP rather than a Claude-only protocol.


