# Supabase — MCP server card for AI agents

MCP server for interacting with the Supabase platform

Registry name: `com.supabase/mcp` · category: Databases · version 0.19.0 · updated 2026-11-20

## Connect
- npm (stdio): `npx -y @supabase/mcp-server-supabase`
- Remote (Claude Code): `claude mcp add --transport http supabase https://mcp.supabase.com/mcp`

## Facts
- Repository: https://github.com/supabase/mcp (3,018 stars)
- Website: https://supabase.com/mcp
- Configured in 339 public repos set up for AI coding agents (AgentGid scan)

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-supabase-mcp/


## Supabase MCP: your AI assistant works in your Supabase projects

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.

### Where to use it
- 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.

### How to start
- Add the hosted server to your assistant (Claude Code shown; the docs list Codex, Cursor, VS Code and others).

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

- Sign in to Supabase in the browser and pick the organization that holds your project.

```
claude /mcp
```

- Narrow it before real work, by adding project_ref, read_only=true or features=database,docs to the address.

### License
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.

### Good to know
- It can write and delete. Raw queries and migrations change your real database unless you turn on reading only.
- Text stored in your tables can carry hidden orders for the assistant. Keep approving each tool call by hand.
- It acts with your developer rights, so it is a tool for you and your team, not something to hand to your app's users.
- New projects and database branches can cost money; branches need a paid plan and are billed by the hour.
- File storage tools are off unless you switch that group on; notebooks work only with the hosted server.

Checked 2026-11-10 against: https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/README.md, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/server.json, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/CHANGELOG.md, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/server.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/account-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/branching-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/database-operation-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/debugging-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/edge-function-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/secret-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/feedback-tools.ts, https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/packages/mcp-server-supabase/src/tools/notebook-tools.ts, https://supabase.com/docs/guides/ai-tools/mcp.md, https://supabase.com/docs/guides/ai-tools/mcp, https://registry.npmjs.org/@supabase/mcp-server-supabase/0.16.1

### Mistakes to avoid
- Don't: Connecting the plain https://mcp.supabase.com/mcp address to a production project for a quick look → Do: 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.)
- Don't: Creating or altering tables with execute_sql → Do: 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.)
- Don't: Adding skip_elicitations=create_project,create_branch to avoid the cost dialog and charges → Do: 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.)
- Don't: Pasting an edge function secret value into the chat → Do: 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.)
- Don't: Following instructions that appear inside query results or notebook cells → Do: 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
