What is Mimic AI MCP?
Mimic AI is an open-source MCP server with a Figma plugin that builds Figma screens from HTML using only your design system. It binds real component instances and variables, blocks raw hex and pixel values at write time, and ends each build with a compliance report.
Mimic AI is an open-source MCP server that turns HTML into Figma using only your design system. It discovers your components, variables and text styles, then builds real layers with component instances, variable bindings and auto-layout, so the output is ready to hand off.
It runs on your machine. The only network calls go to Figma's own API with your own read-only token, and the repo states there is no telemetry.
What it enforces and learns
- The Figma plugin rejects raw hex fills, raw pixel font sizes and off-system fonts when your design system has a matching variable or style.
- Primitive frames are blocked where the design system already has a component, such as buttons, badges, inputs and table cells.
- Component recipes, variant defaults and rules you set by correcting a build are saved per design system library.
- Every build ends with a report of components used, primitives built and why, rule checks and design system gaps.
What you need first
| Mimic AI MCP | |
|---|---|
| Runtime | Node.js 20.6 or newer |
| Figma app | Figma desktop app, since browser Figma is not supported |
| Figma plan | Professional or above, needed to publish and use team libraries |
| Token | A personal access token with five read-only scopes |
| Platforms | macOS and Windows |
Who it is for
Best for
- Design system leads who want to test a system by building real screens and surfacing coverage gaps.
- Agencies and freelancers picking up a client's published library who need on-system screens fast.
- Teams who want a Figma reference that matches their frontend components.
Not for
- If your job is mostly rebuilding a Figma screen from code or a description, Figma Generate Design Skill is the better fit for that.
- When you need design tokens, patterns and rules served from a design system Git repo, Design System MCP is the better fit for that.
- Pick Figma MCP Console when the job is live read and write access to Figma with no API token.
- Go with Build Design Skill when the task is building UI code from a Figma design using your project's existing tokens and components.
Use it with UiChemy
Mimic ends in Figma. UiChemy takes the next step for WordPress: Figma to WordPress converts a finished Figma design into an editable page, and Composer is a visual editor inside your WordPress builder. Click Get Started on uichemy.com.
Connect Mimic AI MCP: Build Figma Screens From Your Design System to your AI client
bash <(curl -fsSL https://raw.githubusercontent.com/miapre/mimic-ai/main/install.sh)Run the installer
Run the one-line installer. It clones the repo to ~/mimic-ai, runs npm install, asks for your Figma personal access token, and offers to register mimic-ai in Claude Code's settings.json for you.
Or register the server by hand
Use the npx config above in your client. The README notes that npx mode does not set FIGMA_ACCESS_TOKEN and that team library support needs the full installer.
Add the Figma plugin
In the Figma desktop app, go to Plugins, then Development, then Import plugin from manifest, and select ~/mimic-ai/plugin/manifest.json.
Connect each session
In Figma, go to Plugins, then Development, then Mimic AI, then Run. The bridge starts when you make your first tool call.
Enable your design system and build
In the Assets panel, turn on your team library once for the document. Then ask for something like a settings page with three form fields and a save button.
Client configuration
{
"mcpServers": {
"mimic-ai": {
"command": "npx",
"args": ["-y", "@miapre/mimic-ai"]
}
}
}Endpoints and ports
install.shServed from the repo's main branch on raw.githubusercontent.com.npx -y @miapre/mimic-aiStarts the server over stdio for clients that register it by hand.plugin/manifest.jsonImported once in Figma under Plugins, Development.docs/HOSTS.mdSetup notes for Claude Code, Cursor, Codex CLI and Gemini CLI.What you can do with it
- Write-time gateThe Figma plugin itself rejects raw values where the design system has a variable, style or component, so the rule holds even when a prompt drifts.
- Real layersOutput is Figma layers with component instances, variable bindings and auto-layout, not a flat image.
- Learning per libraryComponent recipes, variant defaults and your corrections are stored per design system library and replayed on later builds.
- Gap detectionPatterns built from primitives are tracked across builds, and the report recommends components your design system is missing.
- Build reportEach build ends in a report of components used, primitives and reasons, rule compliance and coverage gaps.
- Bulk buildersWhole data tables and bar, line, donut and radar charts are built in one call each.
- Local and read-only tokenEverything runs on your machine, and the Figma token uses five read-only scopes.
- Works with any libraryIt works with a team library, components only, or a public community kit, and enforcement adapts to what the library provides.
Tools it exposes
mimic_status
Part of the status and learning group, which reports the state of a build.
mimic_discover_ds
Discovers the design system on your Figma document in one call.
mimic_ai_knowledge_read
Reads the learned knowledge stored for a design system library.
mimic_ai_knowledge_write
Writes learned recipes and rules to the knowledge store.
mimic_generate_build_report
Produces the compliance-audited report at the end of a build.
mimic_ds_assets
Handles design system setup: discover, preload and set defaults.
figma_list_ds
Lists text styles, fill styles or variables from the design system.
mimic_map_components
Maps source elements to design system components.
figma_create_frame
Creates a frame on the canvas.
figma_create_text
Creates a text layer.
figma_create_shape
Creates a rectangle or an ellipse.
figma_create_svg
Creates an SVG layer.
figma_insert_component
Inserts a design system component instance.
mimic_build_table
Builds a whole data table in one call, including headers, cells, variants and text.
mimic_build_chart
Builds bar, line, donut and radar charts in one call with design system color bindings.
figma_component_text
Sets text overrides on a component instance, singly or in a batch.
figma_set_variant
Sets a component variant.
figma_swap_main_component
Swaps or replaces the main component of an instance.
figma_manage_slot
Fills or resets a component slot.
figma_update_node
Edits a node: text, text style, fill, layout, visibility, position, restyle, move, select or page.
figma_variable_modes
Works with variable modes.
figma_delete_node
Deletes a node.
figma_inspect
Inspects nodes, children, parents, text, pages, selection, variants or sections.
figma_validate_ds_compliance
Validates design system compliance of a build.
mimic_pipeline_resolve
Part of the rendering and charts group.
mimic_compute_chart
Computes chart geometry for the chart builder.
Frequently asked questions
What is Mimic AI MCP?
Mimic AI is an open-source MCP server and Figma plugin that builds Figma screens from HTML or a prompt using your real design system. It binds component instances and variables, blocks raw values at write time, and gives a compliance report after each build.
How do I install Mimic AI?
Run the one-line installer from the README. It clones the repo, installs dependencies, asks for your Figma token and can register the server for you. Then import the plugin manifest in the Figma desktop app and run the plugin each session.
What does Mimic AI need to work?
You need Node.js 20.6 or newer, the Figma desktop app, a Figma Professional plan or above for team libraries, and a personal access token. The token takes five read-only scopes: current user, file content, file metadata, library assets and library content.
Does it cost anything?
No. Mimic is free and open source. The only requirements are your own Figma plan and a read-only Figma token. The README says it has no usage limits of its own, and that design data stays on your machine apart from read-only calls to Figma's API.
Can I use the npx setup instead of the installer?
Yes, with a limit. The npx config works in clients such as Cursor, VS Code and Windsurf, but the README says npx mode does not set the Figma access token and that team library support needs the full installer.
Which AI coding agents work with Mimic AI?
The README says any MCP client works and gives setup for Claude Code, Cursor, VS Code, Windsurf and JetBrains, plus Codex CLI and Gemini CLI in its hosts guide. It is optimized for Claude Code, and other clients get the tools but may follow the build protocol less closely.
Does it learn when my design system changes?
It detects added, removed and changed components and variants at the start of each build by comparing against its cache. The README says detection of variable-level changes, such as a renamed color token, is planned for a future release.


