Skip to main content

Supabase

7 tools for the Supabase Management API — organizations, projects, and raw SQL execution. Implemented in tools/supabaseOps.js.

Setup

  1. Log into supabase.com/dashboard
  2. Go to Account (top-right avatar) → Access Tokens
  3. Click Generate new token, name it, copy it
  4. Add it to .env as SUPABASE_ACCESS_TOKEN

This is an account-level token — it can see and manage every organization and project your Supabase account has access to, not just one project. Treat it like any other credential with broad scope.

Tools

ToolRiskWhat it does
supabase_list_organizationsREADList organizations the authenticated account belongs to
supabase_list_projectsREADList Supabase projects for the authenticated account
supabase_get_projectREADGet details of a single project by its ref/ID
supabase_create_projectHIGHCreate a new Supabase project
supabase_delete_projectDESTRUCTIVEDelete a Supabase project
supabase_run_sqlMEDIUMRun raw SQL against a project's database — creating tables, altering schema, or querying data directly

Example

"List my Supabase projects, then show me the schema of the users table in the
'staging' project."

Claude calls supabase_list_projects to find the project ref for "staging", then supabase_run_sql with a query against information_schema.columns to read the schema.

Known limitation

supabase_run_sql uses the Management API's SQL execution endpoint. Some personal access tokens restrict this capability by default as an extra safety measure on Supabase's side — if a call returns 403, go back to the token's settings and confirm SQL execution is permitted for it, or generate a new token with that permission enabled.