Supabase
Supabase integration for database queries, user authentication, and file storage
The Supabase integration lets your agents query database tables via PostgREST, manage users in Supabase Auth, and work with file storage buckets.
Prerequisites
You need:
- Project URL — Your Supabase project URL (e.g.,
https://xyzcompany.supabase.co). Find this in your Supabase Dashboard under Settings > API. - API Key — Either the
anonkey (respects Row Level Security) orservice_rolekey (bypasses RLS, required for Auth admin tools). Found in the same API settings page.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Supabase from the integration list
- Give the config a display name (e.g., "Supabase - My Project")
- Enter your Project URL
- Enter your API Key (use
service_rolekey if you need Auth admin tools) - Save the agent revision
Using in Your Agent
- In an Agent Step, attach Supabase tools from the tools panel
- The agent uses your integration config for all Supabase API calls
- Tools are referenced as
supabase.list_rows,supabase.create_user, etc.
Available Tools
Database (PostgREST)
| Tool | Description | Action Type |
|---|---|---|
list_rows | Query rows from a table with optional filtering, sorting, and pagination | ReadOnly |
get_row | Get a single row by primary key column and value | ReadOnly |
insert_row | Insert a new row into a table (supports upsert) | Reversible |
update_rows | Update rows matching a filter condition | Reversible |
delete_rows | Delete rows matching a filter condition | Irreversible |
call_rpc_function | Call a PostgreSQL function via RPC | Reversible |
Auth (User Management)
| Tool | Description | Action Type |
|---|---|---|
list_users | List all users with pagination (requires service_role key) | ReadOnly |
get_user | Get a specific user by ID (requires service_role key) | ReadOnly |
create_user | Create a new user (requires service_role key) | Reversible |
update_user | Update a user's email, password, or metadata (requires service_role key) | Reversible |
delete_user | Delete a user (requires service_role key) | Irreversible |
Storage
| Tool | Description | Action Type |
|---|---|---|
list_buckets | List all storage buckets | ReadOnly |
list_objects | List files in a bucket with optional prefix filtering | ReadOnly |
delete_objects | Delete one or more files from a bucket | Irreversible |
create_signed_url | Create a temporary signed URL for private file access | ReadOnly |