FigmaMCP

Figma MCP tutorials

These tutorials show, step by step, how to let Claude Code or Codex work on a live Figma file through FigmaMCP, a free Mac app with a local MCP server and a plugin for the Figma desktop app. Each one is a single task with numbered steps, the prompt to type and what the agent does in reply.

All tutorials

FigmaMCP tutorials
TutorialWhat you getSkill to copy
Edit a Figma file with Claude Code in 5 minutesInstall the Mac app, check the plugin switch, then ask for a first read and a first edit. With a demo video.None
Run a design QA pass on a Figma file with an AI agentThe agent scores one frame on six categories, fixes the lowest ones and repeats until each scores 9 or more.figma-design-qa
Turn a written spec into Figma frames with an AI agentThe agent builds a screen with auto layout, one frame per section and named layers, then checks a picture of it.figma-spec-to-frames
Rename Figma layers with an AI agentThe agent proposes a naming map, waits for your yes, renames each layer and reads the frame again.figma-rename-layers

Which one to start with

  1. Start with the 5-minute tutorial if FigmaMCP is new to you. It sets up the app and checks the connection with a read before the first edit.
  2. Then pick the task you have today. To check and fix a frame, run a design QA pass. To start a new screen from a product spec, turn the spec into frames. To clean up a frame before a handoff, rename its layers.
  3. Work on a duplicate of the file or frame the first time, and use Figma version history to undo a change you do not want.

Before you start

Every tutorial needs the same setup: a Mac with macOS 14 or later, the Figma desktop app and Claude Code or Codex. FigmaMCP does not run in the browser, and you do not create a Figma access token. The full reference is Figma MCP setup for Mac.

The three task tutorials each use a skill: a short instruction file that tells the agent which FigmaMCP tools to call and in which order. The FigmaMCP app installs only the base figmamcp skill. You copy the task skill from the FigmaMCP releases page into ~/.claude/skills/ for Claude Code, or ~/.codex/skills/ for Codex, and start a new session.

What stays the same in every tutorial

Questions

Do the tutorials work with Codex?
Yes. The steps are the same for Claude Code and Codex. Only the folder you copy a skill into is different.
Do I need a skill for the first tutorial?
No. The first tutorial uses only the base figmamcp skill, which the Mac app installs for you.
Where is the full list of tools?
On the tools page. For jobs described by goal rather than by step, see use cases.

Last updated: