Figma MCP vs Figma API
The question “figma mcp vs figma api” mixes two layers. The Figma REST API is an HTTP interface with access tokens and rate limits. An MCP server is a tool your AI agent calls, and some MCP servers use the REST API underneath. FigmaMCP is a free Mac app that works through the Figma desktop app instead. Facts about the REST API are from Figma’s docs, checked 2026-11-13.
| Figma REST API | FigmaMCP | |
|---|---|---|
| What it is | Figma’s HTTP API for your own scripts and apps | A Mac app with a local server and Figma plugin for Claude Code and Codex |
| Authentication | Personal access tokens or OAuth 2 apps, with scopes | No API token |
| Rate limits | Set by seat type, endpoint tier, and plan of the resource; over the limit returns 429 | No call quota from FigmaMCP |
| Tier 1 endpoints (for example GET file, GET image) | View or Collab seat: up to 20 a month. Dev or Full seat: 10, 15, or 20 a minute | Not applicable |
| Retry guidance | 429 responses carry a Retry-After header, in seconds | Not applicable |
| Where it works | Any server or script that can send HTTP requests | Figma desktop on a Mac |
Sources: rate limits, authentication. checked 2026-11-13. Limits may change; read the rate-limit page for the tier of each endpoint and how limits map to plans.
How the limits work
- Figma says limits depend on “the seat type of the user,” the endpoint’s tier, and the location and plan of the resource.
- Tracking differs by auth type: OAuth apps per user, plan and app; plan access tokens per token and plan; personal access tokens per user and plan.
- The 429 response includes a
Retry-Afterheader and a rate-limit-type header that says whether the seat is low or high.
Which one to choose
- REST API: you are building your own integration, a server job, or a pipeline that must run without a person at a Mac.
- FigmaMCP: you want Claude Code or Codex to read and edit the file open on your Mac, with no token to create or store. Edits run only where the “AI can edit this file” switch is on.
An agent that reads through the REST API uses your seat’s limits. FigmaMCP has no call quota of its own, though Figma and your agent still need their own connections.
Download for Mac Version 0.1.10
See also Figma MCP limit reached, official Figma MCP, Framelink and setup.