Setup guide
Connect Figma
Figma connects through the Figma REST API with OAuth 2.0 — no personal access token to paste and no developer app for you to register. You click Connect, approve the scopes on Figma's consent screen, and Modiva can then read files, projects, components, styles, metadata and version history, and export node images across the files you authorize — all through one unified API and MCP server. The connection is read-only: the Figma REST API has no write path for design content. Access tokens live 90 days and Modiva refreshes them for you.
Before you start
- A Figma account with access to the files, projects or teams you want to automate.
- The file key, project id or team id you'll pass to the tools (all readable from the Figma URL).
Step-by-step setup
- 1
Sign in to Modiva
Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.
- 2
Open Connections → New connection
In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social, Ads, CRM, E-commerce, Marketing, Creative, Productivity, Payments, Dev & Infra and Analytics).
- 3
Click Connect on the Figma card
Choose the Figma card and click Connect. Modiva redirects you to Figma's OAuth consent screen — sign in if you aren't already, pick the account you want to connect, and review the scopes Modiva requests (identity, file content, file metadata and version history).
- 4
Approve access
Click Allow on Figma's screen. Figma redirects back to Modiva, the token is stored envelope-encrypted, and the connection turns green. From here an agent can read files and export images through the API and MCP server.
What Modiva can access
Access is scoped to the Figma files you can already reach with your account, and it is read-only: Modiva reads design data and exports images, but it cannot edit design content — the REST API has no write path for it. You can revoke access any time by disconnecting in Modiva or removing the app from your Figma account settings.
- Read your Figma user identity
- Read files, projects, components and styles
- Read file metadata and version history
- Export node images (PNG, JPG, SVG, PDF) and read image fills
Troubleshooting & FAQ
Does Figma connect with OAuth or a personal access token?
With OAuth 2.0. Modiva owns the Figma app and requests the scopes during the OAuth flow, so you never create a developer app or paste a personal access token. You connect your Figma account once from the dashboard and Modiva stores the token encrypted at rest with AES-256-GCM.
Can Modiva edit my designs?
No — the connection is read-only. The Figma REST API can read files, nodes, components, styles, metadata and versions and export images, but it has no write path for design content, so Modiva cannot change frames or layers.
Where do I find a file key, project id or team id?
They're all in the Figma URL. A file URL looks like figma.com/file/<file_key>/..., a project's file list lives under figma.com/files/project/<project_id>/..., and a team URL is figma.com/files/team/<team_id>/.... You pass these to the tools as arguments — Modiva doesn't ask for them at connect time.
What can an agent do with a file?
Read it end to end: file_get returns the document tree, file_nodes_get pulls specific nodes, file_get_meta and file_versions_list cover metadata and history, components_list and styles_list surface the published library, and images_export renders any nodes to PNG, JPG, SVG or PDF.
Do Figma tokens expire?
Access tokens expire 90 days after they're issued. Modiva's worker refreshes them automatically using the refresh token before they lapse, so the connection stays healthy without you reconnecting.
How do I disconnect?
Open Connections, click the Figma row and choose Disconnect — Modiva deletes the stored token immediately. You can also revoke Modiva from your Figma account settings under Security → Authorized applications.
Need help with Figma?
Reach the team any time from our support page, or ask Fin, our AI support agent.