MCP server
Supabase MCP Server
- Maintainer
- Official · Supabase
- Runs
- Remote + local
- Repo
- supabase/mcp
- GitHub
- ★ 2,970, last push 2026-10-24 (checked 2026-10-24)
- License
- Apache-2.0
- URL
- https://mcp.supabase.com/mcp
- Registry
- com.supabase/mcp
- Connects to
- PostgreSQL, Supabase
- DevHunt
- Supabase on DevHunt
Install the Supabase MCP Server
Pick your client. Remote first: nothing to install, and you sign in with OAuth where the client supports it. Config shapes checked against each client's docs on 2026-10-25.
Needs SUPABASE_ACCESS_TOKEN (replace the ... with your value).
Run in a terminal, then /mcp inside Claude Code to sign in. Add --scope project to share it via .mcp.json. docs
claude mcp add --transport http supabase https://mcp.supabase.com/mcp
Customize > Connectors > Add > Add custom connector, paste this URL and sign in. It syncs to Claude Desktop and mobile. docs
https://mcp.supabase.com/mcp
The free plan allows one custom connector. On Team and Enterprise an owner adds it under Organization settings > Connectors.
chatgpt.com/plugins > + > Add custom MCP server, paste the URL, set up sign-in and create it as a plugin. Then @-mention it in a chat. docs
https://mcp.supabase.com/mcp
Workspace admins can turn custom MCP plugins off.
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp"
}
}
}Run codex mcp add supabase --url https://mcp.supabase.com/mcp (then codex mcp login supabase), or add this to ~/.codex/config.toml. The CLI, IDE extension and Codex app share it. docs
[mcp_servers.supabase] url = "https://mcp.supabase.com/mcp"
Run in a terminal (-s user adds it for all projects), then /mcp auth to sign in. In ~/.gemini/settings.json the key is httpUrl. docs
gemini mcp add -s user --transport http supabase https://mcp.supabase.com/mcp
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add --transport http supabase https://mcp.supabase.com/mcp
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"supabase": {
"serverUrl": "https://mcp.supabase.com/mcp"
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). Sign in with opencode mcp auth supabase. docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"supabase": {
"type": "remote",
"url": "https://mcp.supabase.com/mcp",
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"supabase": {
"type": "streamableHttp",
"url": "https://mcp.supabase.com/mcp"
}
}
}Security notes
- Supabase asks you to read its MCP security best practices first (supabase.com/docs/guides/ai-tools/mcp). The server can be scoped to one project and run read-only (project_ref and read_only=true in the URL, for example https://mcp.supabase.com/mcp?project_ref=<project-ref>&read_only=true).
- The remote server runs at mcp.supabase.com, hosted by Supabase. You sign in with OAuth in clients that support it, and it acts with your account's permissions.
- The local server runs with your user's permissions (npx downloads it from npm on first run).
- Needs SUPABASE_ACCESS_TOKEN. Use a key or token with the narrowest scopes (read-only if there is one), and keep it out of config files you commit (.mcp.json, .vscode/mcp.json).
- Connect it to a development database or a read-only user first: the model can run writes and deletes if the credentials allow them.
Source: github.com, checked 2026-11-07.
Alternatives
- MCP Toolbox for Databasesofficial · ★ 17k
One server for Postgres, MySQL, SQL Server, BigQuery, AlloyDB, Spanner and more, with tools you define in YAML.
- Neonofficial · ★ 655
Create Neon Postgres projects and branches, run SQL and plan migrations.
- AlloyDBofficial
Google-hosted server to manage AlloyDB for PostgreSQL clusters and run queries.
- Cloud SQLofficial
Google-hosted server to manage Cloud SQL for MySQL, PostgreSQL and SQL Server instances.
- Prismaofficial
Create Prisma Postgres databases, run migrations and inspect schemas.
- DBHubcommunity · ★ 3.7k
One server for Postgres, MySQL, MariaDB, SQL Server and SQLite with read-only mode.
- Postgres MCP Procommunity · ★ 3.4k
Postgres access with index tuning, explain plans and health checks; read-only by default.
- Convexofficial · ★ 13k
Read tables, run functions and inspect logs of a Convex deployment.
Comparing servers for one product? PostgreSQL MCP servers
FAQ
What does the Supabase MCP Server do?+
Query Postgres, manage tables, migrations, edge functions and branches in your Supabase projects.
Is the Supabase MCP server official?+
Official: built and maintained by Supabase.
How do I add Supabase to Claude Code?+
Run: claude mcp add --transport http supabase https://mcp.supabase.com/mcp, then /mcp inside Claude Code to sign in. Add --scope project to share it with your team through .mcp.json.
How do I use the Supabase MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("http").
Does Supabase work in ChatGPT and claude.ai?+
Yes, it has a remote URL (https://mcp.supabase.com/mcp). In claude.ai add it under Customize > Connectors > Add custom connector; in ChatGPT under chatgpt.com/plugins > Add custom MCP server.
What are the alternatives to the Supabase MCP server?+
Other database MCP servers: MCP Toolbox for Databases, Neon, AlloyDB, Cloud SQL and Prisma.