| name | figrefer |
| description | Read the currently selected Figma element and work with it. Use when: (1) User says 'figrefer', 'figma refer', 'check my figma selection', (2) User wants to implement or analyze a design selected in Figma desktop app, (3) User says 'what am I selecting in figma', 'implement this figma design' |
| argument-hint | [what to do with the selection] |
Figma Refer
Read the user's current Figma desktop app selection and work with it based on their instructions.
Prerequisites
- Figma Desktop MCP must be connected:
claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp
- Figma desktop app open with Dev Mode enabled (Shift+D)
- User has selected a layer/frame in Figma
Workflow
Step 1: Read the Selection
Call these tools in parallel (no nodeId needed — reads current selection):
mcp__figma-desktop__get_screenshot - visual reference
mcp__figma-desktop__get_design_context - code reference with styles, fonts, colors
mcp__figma-desktop__get_metadata - structure, dimensions, positions
Step 2: Present What You See
Summarize the selection for the user:
- What the element looks like (from screenshot)
- Dimensions and position (from metadata)
- Key style properties: fonts, colors, spacing (from design context)
- Layer structure if relevant
Step 3: Follow User Instructions
$ARGUMENTS contains what the user wants to do. Common scenarios:
- "implement this" - Generate code matching the design, adapted to the current project's stack
- "what is this" - Describe the element's properties in detail
- "use this style for..." - Extract style values and apply them
- "compare with my code" - Read the user's code and compare against the Figma design
- No argument - Just show what's selected and ask what they'd like to do
Important Notes
- The design context returns React+Tailwind as a reference. Always adapt to the project's actual framework and styling system.
- If the selection is too large,
get_design_context may return only metadata. Use get_metadata to find specific child node IDs, then call get_design_context on those.
- Use
get_variable_defs (via mcp__figma-desktop__get_variable_defs) if the user asks about design tokens or variables.
- Images from desktop MCP are served from
http://localhost:3845/assets/... and can be used directly in code.