Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

Supabase

by supabase

your AI assistant works in your Supabase projects.

DatabasesOfficialRemote

GitHubWebsite

1. Made by

“The MCP server repository is available at github.com/supabase/mcp.”

The repository belongs to the supabase organization and Supabase's own docs at supabase.com name it as the server's repository; the server wraps Supabase's own platform.

supabase.com/docs/guides/ai-tools/mcp.md

Checked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error

What Supabase does

The official Supabase connector lets an AI assistant such as Claude Code, Codex or Cursor work inside your Supabase projects. It can list your tables, run database queries, change the schema, read logs and deploy server functions for you. You sign in through the browser, so there is no key to paste.

What people use it for

Ask about your database in words

Ask your assistant which tables you have or what a row looks like, and it reads them from your project instead of guessing from old code.

A safe look at a live project

Limit the connection to one project and to reading only, so the assistant can check real data without changing it.

Change tables with tracked migrations

When you ask for a new column or table, the assistant writes the change as a migration, so it is saved in the project's migration history.

Find out why something broke

The assistant reads the project's logs and Supabase's security and performance notices before it suggests a fix, such as a table left without access rules.

Wire up the app's front end

The assistant fetches the project address, the public keys and ready TypeScript types, so your app talks to the right project with correct field names.

Check from a nightly job without a browser

In an automated job there is no one to sign in, so give the connection a scoped access token from an environment variable instead.

Supabase popularity

3,018
GitHub stars, supabase/mcp
213K
downloads last week, @supabase/mcp-server-supabase
339
public agent projects connect it
Supabase: downloads per weeknpm, @supabase/mcp-server-supabase 213,329
Supabase: GitHub starssupabase/mcp 3,018
  • your-digital-rights/yourdigitalrights.org
  • spacehendrix/clauder
  • TeemuSo/saas-template-for-ai-lite
  • tdimino/claude-code-minoan

Tools it gives your agent (41)

What it sends and its license

Sends

every tool call and its results, including rows from your database

To Supabase (mcp.supabase.com) and then the AI model your client uses; on each tool call. Opt out: scope to one project, use read_only=true and features=... to limit what can be read.

Sends

feedback text about Supabase tools

To the Supabase team; only when submit_feedback is called; the tool tells the agent to ask you first. Opt out: disable the feedback group with features=..., or use read_only=true.

The server's code is free under the Apache 2.0 license, also for paid work. Using it costs nothing by itself, but what it creates in your Supabase account is billed as usual.

In a paid app
Yes

The server code is Apache 2.0; using it for paid work is allowed, Supabase usage is billed as usual.

“This project is licensed under Apache 2.0.” source

client-work
With conditions

Fine for building a client's app, but use it as a developer tool; do not give it to the client's end users.

“Instead, use it internally as a developer tool to help you build and test your applications.” source

Pass on its files
With conditions

You may pass on or change the code under Apache 2.0, keeping its license notice.

“This project is licensed under Apache 2.0. See the LICENSE file for details.” source

Is it alive

Latest version

0.19.0 in the registry, updated Nov 20, 2026

Last release

0.16.1 (2026-11-06)

Remote endpoint
yes: one unauthenticated GET to https://mcp.supabase.com/mcp answered 401 (sign-in required) on 2026-11-10

Alternatives

Supabase This page

3,018 starsRemote

DBHub

Pick it if your database is MySQL, SQL Server, SQLite or PostgreSQL outside Supabase

3,870 starsLocalin 23 projects

MCP Toolbox for Databases

Pick it if you want one connector setup for many database types

16.9K starsLocal

supabase-mcp-server-supabase

Pick it if you need the same Supabase tools run on your own machine with a token, not the hosted address

Local

All databases servers

Get started

Tell your AI assistant

“Connect the Supabase MCP server at https://mcp.supabase.com/mcp scoped to my project with read_only=true, list the tables and the security advisors, and ask me before any migration or write query.”

Connect it

claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"

Local development with the Supabase CLI uses http://localhost:54321/mcp, with fewer tools and no browser sign-in.

Mistakes to avoid

Connecting the plain https://mcp.supabase.com/mcp address to a production project for a quick look
Add ?project_ref=<id>&read_only=true (and features=database,docs if that is all you need)

Without them the assistant sees every project you can reach and may run write queries.

Creating or altering tables with execute_sql
Use apply_migration for schema changes, execute_sql for queries

The server's own tool text sends schema changes to apply_migration, which records them as migrations.

Adding skip_elicitations=create_project,create_branch to avoid the cost dialog and charges
Keep the confirmations; skipping them only falls back to quoting the cost in chat

Skipping a form changes how the cost is confirmed, not what you pay.

Pasting an edge function secret value into the chat
Let create_edge_function_secret open the Supabase dashboard and type the value there

The tool asks only for the secret's name and project; the value belongs in the dashboard.

Following instructions that appear inside query results or notebook cells
Treat table contents as data and review the next tool call yourself

Stored user text can carry prompt injection that tries to run other queries.

Questions

Do I need an API key?

No for the hosted server. Your assistant opens a browser window where you sign in to Supabase. A personal access token is only needed for CI jobs or clients that cannot do the browser sign-in.

Can it delete my data?

It can run any SQL unless you set read_only=true. With a client that supports forms it asks you before statements it sees as destructive, but that check is a guardrail, not a guarantee.

Can it create things that cost money?

Yes, create_project and create_branch. It shows the cost and waits for your yes when your client supports forms, otherwise the assistant quotes the cost in chat first.

Does it work with a local Supabase?

Yes. The Supabase CLI serves it at http://localhost:54321/mcp, with fewer tools and no browser sign-in.