How to connect Gemini CLI to Figma
Install Figma’s official Gemini CLI extension, complete OAuth and retrieve design context from a specific frame.
Free guide · Updated
Based on official documentation · Checked
Ask your agent
Copy the prompt and paste it into your assistant.
Quick answer
Install the official Figma extension for Gemini CLI and authenticate the figma MCP server from the interactive client. This guide uses Figma’s recommended remote setup, which connects to Figma without requiring the desktop application.
1. Prepare a design link
Install Gemini CLI and choose a Figma file your account can open. In Figma, right-click a small frame or layer and select Copy link to selection. A frame link identifies the node to retrieve; the file browser homepage does not.
2. Install the official extension
Run the documented extension installation command in your terminal:
gemini extensions install https://github.com/figma/mcp-server-guide3. Authenticate inside Gemini CLI
Start the interactive client:
geminiAuthorize Figma
Inside that session, run the MCP authentication command and complete the browser sign-in with your intended Figma account:
/mcp auth figmaPractice
4. Read the selected frame
- Paste the frame link and ask Gemini CLI to use Figma tools to report its text, layout, components and variables. Compare the response with the original frame before asking for code.
Output: Gemini retrieves context matching the selected node, including design details that can be checked in Figma.
5. Use the context in your project
Ask for a small implementation using your existing framework and components. Review spacing, typography and assets against the retrieved design. Narrow a large design to one frame or component if the context request is too broad.
Troubleshooting
Authentication failure: inspect the figma connection and authorized account. File denied: confirm that account can open the exact file. Wrong design: copy a fresh link to the selected node. Missing extension: confirm installation completed and restart Gemini CLI. Remote and desktop MCP setup are separate methods; a localhost desktop endpoint is not the remote server.
Uninstall the extension
Use Figma’s documented removal command when you no longer need this connection:
gemini extensions uninstall figmaSources
Read the primary material
- Gemini CLI and Figma setupFigma
- Figma RemoteFigma