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
| Tutorial | What you get | Skill to copy |
|---|---|---|
| Edit a Figma file with Claude Code in 5 minutes | Install 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 agent | The 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 agent | The 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 agent | The 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
- 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.
- 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.
- 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
- The agent edits only the file where the plugin is open and its AI can edit this file switch is on. With the switch off, it can only read.
- Each edit must name its target layer exactly, and a bulk edit with one invalid item changes nothing. See Is it safe?
- The agent tells you what it will change and reports what it did. You still check the result in Figma.
Questions
Do the tutorials work with Codex?
Do I need a skill for the first tutorial?
Where is the full list of tools?
Last updated: