io.github.dannykeane/figmanage

Change access level for a user on a file, project, or team. Looks up the role by user_id.

Share a file or project with someone by email. Sends an invite.

Remove a user's access to a file, project, or team. The user loses access immediately.

Check figmanage authentication status and get setup instructions. Always call this before using any other tool.

Extract Figma session cookies from Chrome. On macOS this triggers a Keychain prompt. IMPORTANT: Before calling, confirm the user is logged into figma.com in Chrome and knows a system prompt may appear.

Select a Figma account and validate the session. Call after setup_extract_cookies.

Validate and save a Figma Personal Access Token. Completes setup and activates all tools.

Create a new Figma file in a project. Supports design, whiteboard, slides, sites.

Rename a Figma file.

Move one or more files to a different project. Supports batch moves.

Duplicate a file. Optionally specify a destination project.

Move files to trash (recoverable via restore_files). Supports batch operations.

Restore files from trash.

Add or remove a file from your sidebar favorites.

Set link access on a file. Use "inherit" to remove custom access and fall back to project/team defaults.

Audit and optionally execute user offboarding. Default: read-only audit. With execute=true: transfers file ownership, revokes access, downgrades seat. With remove_from_org=true: also permanently removes the user from the org (cannot be undone).

List pending file access requests. These come through the notification system.

Invite a user to teams and optionally share files and set seat type. Sends invite emails per team.

Org-wide design ops snapshot: seat utilization, team activity, billing, and library adoption over a given period.

Approve a pending file access request by notification ID.

Team-level library adoption metrics. Shows how a published library is used across teams.

Per-file component usage analytics. Shows which files use a specific component.

List comments on a file. Returns comment text, author, timestamps, and thread structure.

Post a comment on a file. Optionally pin to a specific node or reply to an existing comment.

Permanently delete a comment. For top-level comments, the entire thread is removed. Cannot be undone.

List emoji reactions on a comment.

Resolve or unresolve a comment thread. Resolved comments are collapsed in the Figma UI.

Edit the text of an existing comment.

Add an emoji reaction to a comment.

Remove your emoji reaction from a comment.

List dev resources (links, annotations) attached to nodes in a file. Used in Dev Mode.

Create a dev resource (link/annotation) on a node. Visible in Dev Mode.

Delete a dev resource from a file.

List all design system libraries in the org with sharing group info.

Read file contents as a node tree. Use depth to limit response size (full trees can be very large). depth=1 returns pages only. To read a branch, use the branch file key from list_branches.

Read specific nodes from a file. Returns the full node tree for each ID including type, name, layout properties, fills, strokes, and children.

List version history for a file. Returns named snapshots and auto-saves.

Create a named version (checkpoint) in a file\'s history.

List webhook subscriptions for a team. Returns webhook IDs, endpoints, event types, and status.

Create a webhook subscription for a team.

Update a webhook's endpoint, event type, passcode, description, or status (ACTIVE/PAUSED).

List recent webhook delivery attempts (last 7 days). Shows payload, response status, and errors.

Permanently delete a webhook. The webhook stops receiving events immediately. Cannot be undone.

Create a new project (folder) in a team.

Rename a project (folder).

Move a project to a different team.

Move a project and all its files to trash. Recoverable via restore_project.

Restore a project from trash.

Set or update a project description.

See who has access to a file, project, or team. Returns users with roles and role IDs.

Decline a pending file access request by notification ID.

Quick overview of a Figma file. Fetches pages, components, styles, and comment counts in parallel.

Full org snapshot: teams with member/project counts, seat breakdown, and billing summary.

Aggregated unresolved comments across all files in a project. Checks up to 20 files.

Find files not modified in N days and optionally trash them. dry_run=true (default) previews which files would be trashed without trashing them. Set dry_run=false to execute.

Move files into a target project in a single batch. Files are moved (not copied) from their current project.

Create multiple projects in a team from a plan. Optionally set descriptions.

Identify inactive paid seats and calculate potential savings. Fetches members, seat counts, and pricing to find optimization opportunities.

Audit permissions across a team or project. Scans files for external editors, open link access, and elevated individual permissions.

Find stale branches across a project and optionally archive them. dry_run=true (default) previews which branches would be archived. Archives move branch files to trash (recoverable).

Create a new team in the org.

Rename an existing team.

Permanently delete a team and all its projects/files. This cannot be undone. All team members lose access.

Add a member to a team by email. Level: 100 = can view (default), 300 = can edit, 999 = admin.

Remove a member from a team. The user loses access to all team projects and files.

List org admins with their permission levels, seat status, and email validation state.

List all teams in the org with member counts, project counts, and access levels.

Seat usage breakdown: permission counts, seat types, activity recency, and account type distribution.

List members of a team with name, email, avatar, last active date, and role.

Org billing data including invoice history, status, amounts, and billing periods.

List open and upcoming invoices for the org.

Org domain configuration and SSO/SAML settings.

AI credit usage summary. Provide a team_id and the plan is resolved automatically, or pass plan_id directly.

Trigger async CSV export of all org members. The CSV is sent to the admin email on file.

List org members with seat type, permission, email, and last active date. Use to resolve org_user_ids for change_seat.

Seat pricing for the org. Returns monthly cost per seat type (expert, developer, collaborator).

Change a user\'s seat type. Accepts user_id or email to identify the user. Upgrades affect billing.

Org audit log. Shows who did what, when. Filter by email for per-user activity. Supports date ranges and cursor pagination.

List paid invoices / payment history for the org.

Permanently remove a member from the org. They lose all access to teams, projects, files, and apps. Cannot be undone. Requires confirm: true.

Create a user group. Provide team_id to auto-resolve the billing plan, or pass plan_id directly.

Delete one or more user groups by ID.

Add members to a user group by email.

Remove members from a user group by user ID.

List local variables and variable collections in a file. Requires Enterprise plan.

List published variables from a library file. Requires Enterprise plan.

Bulk create, update, or delete variables, collections, modes, and mode values. Requires Enterprise plan. Each operation object needs an action field (CREATE, UPDATE, or DELETE). Deletions are immediate and cannot be undone -- list variables first to verify IDs.

Check authentication status for both PAT and session cookie

List all Figma workspaces (orgs) you belong to. Shows which is currently active.

Switch active workspace. Accepts org name (fuzzy match) or ID. Use list_orgs to see available workspaces.

List all teams you belong to. Returns team IDs and names.

List projects (folders) in a team. Returns project IDs, names.

List files in a project. Returns file keys, names, last modified, editor type. Supports pagination.

List your recently viewed/edited files across all teams.

Search for files across the workspace. Requires org context for results.

Get metadata for a file: name, last modified, editor type, project, team.

List your starred/favorited files. Note: may not work on all account types.

List components published from a file. Only published library components appear -- local unpublished components are not included.

List styles published from a file. Only published library styles appear.

List published components across a team. Pass the cursor from the response\'s pagination object to fetch the next page.

List published styles across a team. Pass the cursor from the response\'s pagination object to fetch the next page.

List branches of a file.

Create a branch from a file.

Archive (delete) a branch. Uses the branch file key from list_branches.

Export specific nodes from a file as images. Returns temporary URLs (valid ~14 days).

Get download URLs for all images used as fills in a file.