update_token
Override a design token's value locally and optionally push the change to Figma.
Instructions
Update a design token value in the local registry, and optionally push the change back to Figma.
Prerequisites: Token must already exist in the registry (use get_tokens to list names). To push to Figma, a plugin connection is also required.
Returns on success: Plain confirmation string Token "<name>" updated.
Error behavior: Returns isError if the token name is not found in the registry. If pushToFigma is true but Figma is not connected, the local update still succeeds — the push is silently skipped (no error thrown). To verify the push landed in Figma, capture a screenshot afterward.
Use this tool: to apply a token override (e.g. change a brand color for a client theme) and optionally propagate it to Figma immediately. For bulk token mapping to Tailwind, use sync_design_tokens instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Exact token name as it appears in get_tokens output (e.g. "Colors/Primary", "Spacing/XS"). Case-sensitive. | |
| values | Yes | Mode-to-value map to merge into existing values (e.g. { "Light": "#FF0000", "Dark": "#FF6666" }). Only the modes you provide are updated — other modes are preserved. | |
| pushToFigma | No | If true and Figma is connected, push this token change to the Figma file immediately. Defaults to false (local registry only). |