Skip to main content
Preview. Figma MCP must be enabled for your organization before it appears in Settings. Contact your Gradial team to get access.
Figma MCP connects Grady to Figma’s MCP server so it can work directly with your design files: inspect frames and components, capture screenshots, and make edits you ask for. Each person connects their own Figma account, so Grady sees exactly the files that person can see in Figma — nothing more.

​
What you can do

  • Pull design context into a task. Paste a Figma link and ask Grady to describe the layout, extract copy, or list the components and styles a frame uses.
  • Get screenshots of specific frames. Grady can capture an image of a node to compare against a live page or share in a review.
  • Make requested edits. Grady writes to Figma only when you ask for a change, and only to the file and nodes you point it at.
  • Trace answers back to the source. Grady names Figma as the source, links to the exact file and node, and notes when the content was fetched.

​
How it fits together

  1. An admin enables Figma MCP for the organization under Settings → Integrations. Gradial supplies the Figma server, scope, and app credentials, so there is nothing to configure.
  2. The admin assigns it to one or more Environments. Workspaces in those Environments can then use it, the same as any other integration.
  3. Each user connects their own Figma account from the same card. Until they do, Grady cannot reach Figma on their behalf.
  4. Users work with Figma through Grady. There is no separate Figma panel — paste a Figma link into a chat or task and describe what you need.

​
Prerequisites

  • Figma MCP is enabled for your organization by Gradial (see Access above)
  • An organization role with permission to manage Gradial settings, for the one-time enablement
  • A Figma account for each user who will connect, with access to the files they want Grady to work with

​
Setup

1

Enable Figma MCP (admin, once per organization)

Go to Settings → Integrations and select the Figma MCP card. In the Enable Figma MCP dialog, click Enable.Users who aren’t admins see a prompt to ask an admin instead.
2

Assign Figma MCP to Environments (admin)

Open the new Figma (MCP) integration and add the Environments whose Workspaces should use it.
3

Connect your Figma account (each user)

On the Figma MCP integration, click Connect, sign in to Figma, and approve access. You return to Gradial when the connection completes.
4

Verify the connection

In a Workspace that uses one of the assigned Environments, ask Grady:
Grady should reply with your Figma account. Then paste a Figma link and ask for a short description of a frame.

​
How Grady handles your Figma content

  • Your access, not more. Grady acts as the connected user and can only reach files that user can open in Figma. It never uses another person’s connection.
  • On request only. Grady retrieves Figma content for the request in front of it. It does not run scheduled or background retrieval, bulk exports, or build searchable copies of your files, and it does not store Figma content in skills or memory.
  • Not used for training. Figma content is not used to train AI models.
  • Writes stay in scope. Grady confirms the target file and nodes from your request before making changes and does not edit beyond what you asked.

​
Limitations

  • Interactive use only. Figma MCP is available in tasks and chats started by a person. Automated runs — for example, tasks created from a ticketing queue — cannot use it.
  • Figma rate limits apply. Figma limits MCP usage by plan and seat type. When a limit is reached, Grady tells you which limit was hit and shares Figma’s upgrade link instead of retrying.

​
Troubleshooting

​
Need help?

Contact your Gradial representative or Gradial Support for help enabling or troubleshooting Figma MCP.