# Figma Use Motion

Motion / animation context for the `use_figma` MCP tool, animating Figma nodes via...

- Repository: https://github.com/figma/mcp-server-guide (2138 stars)
- Category: Design
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add figma/mcp-server-guide --skill figma-use-motion -g -a claude-code -y`
Codex: `npx skills add figma/mcp-server-guide --skill figma-use-motion -g -a codex -y`
Cursor: `npx skills add figma/mcp-server-guide --skill figma-use-motion -g -a cursor -y`
Gemini CLI: `npx skills add figma/mcp-server-guide --skill figma-use-motion -g -a gemini-cli -y`

## Description

Motion / animation context for the `use_figma` MCP tool, animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# use_figma, Figma Plugin API Skill for Motion

Motion context for the `use_figma` MCP tool. [figma-use](../figma-use/SKILL.md) covers the foundational Plugin API rules, load both together.

**Always pass `skillNames: "figma-use-motion"` (comma-separated alongside `figma-use`) when calling `use_figma` for motion work.** Logging only.

## Runtime Gating

Motion APIs are gated behind the `metronome` user feature flag. When the calling user doesn't have it, every motion property and helper referenced in this skill throws `"<name>" is not a supported API`.

**Bail out fast on that error.** Do not retry; tell the user motion isn't enabled for them and stop. Otherwise you'll burn calls and confuse the user with repeated identical failures.

## When to use this skill

Load this skill whenever a `use_figma` task involves:

- Adding, editing, or removing keyframes on a node (`manualKeyframeTracks`, `applyManualKeyframeTrack`, `removeManualKeyframeTrack`).
- Animating fill or stroke colors over time.
- Applying, editing, or removing animation styles (`applyAnimationStyle`, `removeAnimationStyle`, `animationStyles`).
- Reading or writing timeline duration via `node.timelines` / `node.setTimelineDuration(id, seconds)`.
- Choosing easing for any of the above.

Static design work (creating shapes, components, variables, layout) goes through [figma-use](../figma-use/SKILL.md) alone, this skill is only for the time dimension.

## Exposed motion API surface

The rest: https://github.com/figma/mcp-server-guide/blob/HEAD/skills-figquery/figma-use-motion/SKILL.md