Resources · Claude connector

Claude Supabase connectorWhat Claude can do in your Supabase account.

The Claude Supabase connector exposes 32 tools. 18 read your organisations, projects, tables and settings, 12 change something, including raw SQL, and 2 are listed without a description. Below: what Claude reaches, what it can break, and the safeguards Supabase asks for.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What changes when your database answers in plain words

Supabase describes its connector as a way for an assistant to query and work on your projects on your behalf. In practice, you ask Claude which tables exist, what a migration changed or why a function fails, and it goes to look instead of you opening the dashboard. The same access that makes this handy is why Supabase spends so much of its page on risk: this connector can change a live database.

Understand a project fast. A product manager inherits an app and asks what is in the database. Claude lists the tables with list_tables, the installed extensions with list_extensions and the migration history with list_migrations.

Catch problems early. get_advisors returns Supabase's security and performance advisors, so Claude can flag a weak spot before it reaches users.

Ship a change. A developer asks for a new column: apply_migration applies the migration, and deploy_edge_function pushes an updated Edge Function. execute_sql runs any SQL query, reads and writes alike unless read-only mode is on.

What it will not do on its own: stay safe by default. Supabase recommends scoping to one project, turning on read-only mode and limiting tool groups before touching production. Nothing runs by itself either: no tool reacts to a new row. For that, a scenario tool fits better, and the Supabase n8n integration and Supabase Make integration pages cover it. They do different jobs.

Vocabulary

The vocabulary in one minute

Five words you will meet while plugging Supabase into Claude.

Connector
The link you set up once between Claude and an account you already have, so Claude can work in it while it answers you.
Tool
One named action the connector opens to Claude. Claude picks the ones it needs by itself; the directory lists them by name.
Authorization
The sign-in screen of Supabase itself, where you hand Claude the access it will use. Given once per person, and you can take it back.
Approval
The confirmation Claude waits for before it finishes something that changes your account, shown right in the conversation.
MCP
The shared standard connectors are built on: it is what lets an assistant like Claude talk to an outside service such as Supabase.
Connect

Connect Supabase to Claude in three steps

  1. 01

    Find Supabase in Claude

    In Claude's settings, open Customize, then Connectors, and look for Supabase in the list. On a Team or Enterprise workspace, an Owner or Primary Owner has to switch the connector on before each member can sign in.

  2. 02

    Start the connection

    Click Connect on its row and sign in to Supabase in the window the service opens itself. If the link breaks one day, use Disconnect, then plug it back in from the same row.

  3. 03

    Read the authorization screen

    Read the service's screen before you accept. It belongs to Supabase, not Claude, and it decides what the access covers. You can also withdraw that access later from your Supabase account.

Tools

The 32 tools, grouped by what they do

Supabase gives Claude 32 tools: 18 that read your account, 12 that change something in it, and 2 no official source describes.

Three groups: what Claude reads, what it changes, and two names no source explains. Names stay in English, as Claude shows them.

  • 18 read
  • 12 write
  • 2 not documented

What Claude reads (18)

18 tools

Eighteen tools that look at organisations, projects, the database, functions and storage settings without changing them.

list_organizations

Lists the Supabase organisations your account belongs to. Supabase files it under organisation management, next to the tool that opens one organisation in detail.

When it helps
a freelancer works for three clients and wants to see which organisations the connection reaches.

Sourcesupabase.com · September 30, 2026 ↗

get_organization

Returns the details of one organisation. Supabase files it under organisation management, alongside the listing tool.

When it helps
you want to confirm which organisation a project sits in before touching it.
Watch out
it covers one organisation; the full list comes from list_organizations.

Sourcesupabase.com · September 30, 2026 ↗

list_projects

Lists your Supabase projects so Claude knows which one you mean. Supabase pairs it with the tool that returns one project's details.

When it helps
you ask about "the staging app" and Claude checks which project carries that name.
Watch out
it names the projects; one project's detail comes from get_project.

Sourcesupabase.com · September 30, 2026 ↗

get_project

Shows one project in full, the companion of the listing tool. Supabase groups the two under a single line, so Claude uses this one once it knows which project you mean.

When it helps
before a demo, you want to know whether a project is active or paused.

Sourcesupabase.com · September 30, 2026 ↗

get_cost

Gives cost information; Supabase's list says no more than that, and pairs it with confirm_cost.

When it helps
a founder wants cost information in hand before planning a new project.
Watch out
Supabase's list says nothing about what the figures cover.

Sourcesupabase.com · September 30, 2026 ↗

list_branches

Lists the development branches of a project. Supabase puts it in its branch management group.

When it helps
you want to see which feature branches are still open before a release.
Watch out
it lists branches only; the other tools of the branch group are the ones that act on them.

Sourcesupabase.com · September 30, 2026 ↗

list_tables

Lists every table in the database, a quick picture of what the project stores.

When it helps
a new analyst asks where customer orders live before drafting a single query.
Watch out
it names the tables and returns none of their rows; reading data goes through execute_sql.

Sourcesupabase.com · September 30, 2026 ↗

list_extensions

Shows which Postgres extensions are available and which are installed on the database.

When it helps
you want to know whether vector search or geographic types are already switched on.
Watch out
it reports what is there and switches nothing on.

Sourcesupabase.com · September 30, 2026 ↗

list_migrations

Returns the list of database migrations, the record of every structural step taken so far.

When it helps
a bug appeared last week and you want to see which migrations landed around then.
Watch out
it shows the history; apply_migration is a separate tool.

Sourcesupabase.com · September 30, 2026 ↗

get_advisors

Returns Supabase's security and performance advisors for the project, the warnings it raises about its own setup.

When it helps
before launch, a CTO asks Claude to go through every open security warning.
Watch out
it reports the warnings and leaves the project as it is.

Sourcesupabase.com · September 30, 2026 ↗

get_project_url

Gives the API address of a project, the one an app uses to reach it.

When it helps
a front-end developer needs the right address for the staging environment.
Watch out
it gives the address only; the keys come from get_publishable_keys.

Sourcesupabase.com · September 30, 2026 ↗

get_publishable_keys

Returns a project's publishable API keys, plus the legacy anon keys.

When it helps
you are wiring a mobile app and need the key that goes in its settings.
Watch out
Supabase describes these as publishable and legacy anon keys, not every key of the project.

Sourcesupabase.com · September 30, 2026 ↗

generate_typescript_types

Generates TypeScript types from your database schema, so application code matches the tables exactly. The database itself stays as it is.

When it helps
after the schema moved on, a developer wants fresh types without running the command locally.
Watch out
the types follow the schema as it stands when Claude calls the tool.

Sourcesupabase.com · September 30, 2026 ↗

search_docs

Searches Supabase's documentation, so Claude answers how-to questions from the source rather than from memory.

When it helps
you ask how row-level security policies work and want the official explanation.
Watch out
it searches Supabase's documentation, not the data of your project.

Sourcesupabase.com · September 30, 2026 ↗

list_storage_buckets

Lists a project's storage buckets. It belongs to the Storage group, which Supabase leaves off by default.

When it helps
you want to know where uploaded invoices end up.
Watch out
without the Storage group enabled, this tool is not there.

Sourcesupabase.com · September 30, 2026 ↗

get_storage_config

Reads the storage configuration of a project. Like the rest of the Storage group, it is disabled until you turn that group on.

When it helps
an upload fails and you want to check the storage settings first.
Watch out
like the rest of the Storage group, it is absent until that group is enabled.

Sourcesupabase.com · September 30, 2026 ↗

list_edge_functions

Lists all the Edge Functions of a project, the server-side functions it hosts.

When it helps
you inherit a project and want to know what server-side code it depends on.
Watch out
it lists the functions; one function's detail comes from get_edge_function.

Sourcesupabase.com · September 30, 2026 ↗

get_edge_function

Fetches one specific Edge Function of the project, picked out of the list.

When it helps
a payment webhook misbehaves and you want Claude to look at that one function first.
Watch out
it reads one function; deploy_edge_function is a separate tool.

Sourcesupabase.com · September 30, 2026 ↗

What Claude changes (12)

12 tools

Twelve tools that create, alter or remove something, raw SQL included. No source describes a confirmation specific to them: the general rule below applies.

create_project

Approval: see the rule

Creates a new Supabase project. Supabase lists it with pausing and restoring under project management.

What Claude asks for
no source describes a Claude confirmation for this tool; the general rule below applies.
When it helps
you need a sandbox project for a prototype this afternoon.

Sourcesupabase.com · September 30, 2026 ↗

pause_project

Approval: see the rule

Pauses a project, one of the three project management actions Supabase lists.

What Claude asks for
nothing tool-specific is documented; see the approval section below.
When it helps
an old demo project should stop running until someone needs it again.

Sourcesupabase.com · September 30, 2026 ↗

restore_project

Approval: see the rule

Restores a project, the counterpart of pausing in Supabase's project management group.

What Claude asks for
no confirmation is described for this tool; the general rule covers it.
When it helps
the paused demo is needed again for a client meeting tomorrow.

Sourcesupabase.com · September 30, 2026 ↗

create_branch

Approval: see the rule

Creates a development branch for the database. Supabase files it under branch management.

What Claude asks for
no source says whether a confirmation shows; the approval section applies.
When it helps
you want to try a risky schema change away from production.

Sourcesupabase.com · September 30, 2026 ↗

delete_branch

Approval: see the rule

Deletes a development branch, the removal tool of the branch management group.

What Claude asks for
nothing specific is documented; see the general rule below.
When it helps
a finished feature branch is cluttering the project.
Watch out
check the branch name twice before asking.

Sourcesupabase.com · September 30, 2026 ↗

merge_branch

Approval: see the rule

One of three branch operations Supabase lists together, with no line of its own. It acts on a project's branches rather than reading them.

What Claude asks for
no confirmation is described for this tool; the approval section covers it.
When it helps
a tested branch is ready and you want to bring it into the project.

Sourcesupabase.com · September 30, 2026 ↗

reset_branch

Approval: see the rule

Another of the branch operations Supabase groups together without a separate description. It changes the state of a branch.

What Claude asks for
nothing tool-specific is published; the general rule below applies.
When it helps
a branch got messy during testing and you want a clean start.
Watch out
Supabase gives no detail on what a reset keeps.

Sourcesupabase.com · September 30, 2026 ↗

rebase_branch

Approval: see the rule

The third branch operation in Supabase's list, again without its own description. It modifies a branch, it does not just read it.

What Claude asks for
no source describes a confirmation here; see the approval section.
When it helps
a long-running branch has fallen behind and you want to bring it up to date.

Sourcesupabase.com · September 30, 2026 ↗

apply_migration

Approval: see the rule

Applies a database migration, changing the structure of your tables for real.

What Claude asks for
no confirmation is described for this tool; the general rule covers it.
When it helps
a developer needs a new column on the orders table before a release.
Watch out
on a production project, this changes the live schema.

Sourcesupabase.com · September 30, 2026 ↗

execute_sql

Approval: see the rule

Runs SQL queries against the database. A query can read data or change it; Supabase offers a read-only mode that runs every query as a read-only Postgres user instead.

What Claude asks for
no source describes a Claude confirmation for this tool; see the approval section.
When it helps
a support lead wants the number of sign-ups per week for the last quarter.
Watch out
without read-only mode, a single query can alter or delete rows.

Sourcesupabase.com · September 30, 2026 ↗

update_storage_config

Approval: see the rule

Changes the storage configuration of a project. It sits in the Storage group, off by default.

What Claude asks for
nothing specific is documented; the general rule below applies.
When it helps
uploads need new settings before a feature launch.

Sourcesupabase.com · September 30, 2026 ↗

deploy_edge_function

Approval: see the rule

Deploys an Edge Function to the project, new or updated, so it starts running server-side.

What Claude asks for
no source says whether a confirmation shows; the approval section applies.
When it helps
a fixed webhook handler has to go live before the next batch of payments.

Sourcesupabase.com · September 30, 2026 ↗

Not documented (2)

2 tools

The directory publishes these two names. Supabase's page does not describe them under these names, and this page will not guess.

confirm_cost

Supabase's page mentions this name next to get_cost under the heading of cost information, and says nothing more about it. No Claude page describes it either, so this page does not say whether it reads or changes anything.

Watch out
the general approval rule below covers it.

get_logs

The directory lists this name, but Supabase's page describes a differently named logs tool and never this one. No source explains it, so this page leaves it undescribed.

Watch out
whatever it turns out to do, the approval section applies to it.
Approvals

What Claude asks before acting

By default, Claude stops and asks for your go-ahead before each action it carries out on an account for you. The request shows up in the conversation, at the moment it matters.

On Team and Enterprise, workspace owners decide whether a member can let some actions through without being asked every time. They can also cap what a connector may do for the whole organisation, keeping reading open and closing writing, for example. That setting applies to everyone and nobody gets around it from their own account. And Claude works with your rights, nothing more: what you cannot reach in Supabase stays out of its reach too.

Plans

Which plans it works on

None of the 819 sheets in the official directory shows availability by plan. The answer, connector by connector, is not published anywhere: it is a real gap in the catalogue.

The general rule is published: remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, and desktop extensions install on Claude Desktop. On Team and Enterprise, an Owner or Primary Owner turns the connector on for the organisation before members can connect. For the current state, check the connector's sheet in the official directory.

Limits

Where this connector stops

A connector is not an automation. Claude calls these tools while it answers you: nothing starts when a row is inserted, a function fails or a migration lands.

The tool list is an observed floor, not a promise: an administrator can open actions that no public sheet shows. The partner badge in the directory is not a security audit either, and Anthropic says so on every sheet: it does not choose the tools a publisher exposes and does not guarantee they behave as described. Everything below comes from Supabase's documentation, since neither Claude's help centre nor Anthropic's docs have a page on this connector. For a connector with a gentler write surface, compare with the Claude airtable connector.

Need help

Need help connecting Supabase to Claude?

A person reads every message.

FAQ

FAQ about the Claude Supabase connector

01What can Claude do with the Supabase connector?
Claude can inspect and manage your Supabase projects from a conversation. Eighteen documented tools read organisations, projects, tables, extensions, migrations, advisors, keys, Edge Functions and storage settings, and search the docs. Twelve more create, pause or restore projects, manage branches, apply migrations, run SQL, deploy Edge Functions and update storage settings. Two further names have no description. It suits questions like which tables exist or why a function fails. Claude picks the tools it needs as it goes.
02Can Claude change or delete things in my Supabase database?
Yes. Twelve documented tools change something, and execute_sql can run any query, including ones that alter or delete rows, unless read-only mode is on. Claude can also apply migrations, deploy Edge Functions, delete or reset branches, and pause or create projects. Before connecting production, Supabase advises read-only mode, scoping the connection to that project and restricting feature groups. Its documentation also warns that production projects can contain sensitive data, which is why it lists these steps.
03Does Claude ask before it runs SQL or applies a migration?
By default, Claude asks for confirmation before each action it carries out on an account for you. No source describes a confirmation specific to a Supabase tool, so the default rule covers them. Supabase itself recommends keeping manual approval on for interactive work and reviewing every tool call before it runs. On a Team or Enterprise workspace, owners can also close writing for the whole organisation while keeping reads open.
04Which plans is it available on?
No official source publishes availability by plan, connector by connector, and no directory sheet shows it. The general rule says remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, with an Owner or Primary Owner switching them on first on Team and Enterprise. The connector's sheet in the official directory, checked from your own signed-in account, is the only place that shows its current state.
05Does Claude see every project in my Supabase account?
It works with your developer permissions, so what those permissions reach is what the connection can reach. Supabase lets you scope it to a single project, which limits Claude to that project and removes the account-level tools. Because of those developer permissions, Supabase adds, the connection should never be handed to customers or end users. On a Team or Enterprise workspace, an owner can further restrict what the connector may do for everyone, and nobody lifts that from their own account.
06Is the Claude Supabase connector safe to use on production data?
Supabase's answer is: only with precautions. Its documentation names prompt injection as the main risk, where instructions hidden in stored data trick the model into running bad queries. Before connecting a production project, it recommends scoping to that project, turning on read-only mode, restricting feature groups and reviewing the security risks. It also advises keeping manual approval on for interactive work and reviewing each tool call before it runs, and it warns that production projects can hold sensitive data.
07Claude or an automation tool for Supabase?
They answer different needs, so it depends on the task. Claude works inside a conversation: you ask, it queries, explains or changes something, and nothing more happens once you stop typing. It will not react on its own to a new row or a failed function. For a process that runs on each database event in the background, an automation tool is the right fit. For investigation and one-off changes on demand, the connector is.