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 Integrations from the sidebar
- Select Supabase from the catalog
- Click Add Integration Config
- 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 config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Supabase tools from the tools panel
- 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 |