Skip to content
PerSQL PerSQL PerSQL

Figma

PerSQL gives your Figma plugin a real database. Register a file and read or write structured data keyed to it — persistent state with no server to stand up.

Connect

Section titled “Connect”

  1. Go to figma.persql.com/install/start, authorize your Figma account, and connect it to your PerSQL workspace.

  2. Map a Figma file to a PerSQL database, keyed by its file key. Your plugin then queries that database over the API.

Query from the plugin

Section titled “Query from the plugin”
import { PerSQL } from "@persql/sdk";


const db = new PerSQL({ token: process.env.PERSQL_TOKEN })
  .database(process.env.PERSQL_DATABASE);


await db.query(
  "INSERT INTO annotations (node_id, note) VALUES (?, ?)",
  [nodeId, note],
);

Point an agent at the Figma MCP to manage registrations:

https://figma.persql.com/mcp

Authenticate with a PerSQL bearer token. figma_register_file maps a file to a database; figma_install_list shows connected Figma users.