Supabase · supabase — Claude Code MCP server: what it does, install
This MCP server lets an agent search Supabase docs and manage projects, databases, migrations, Edge Functions, and development branches.
no license 177 installs updated 2025-10-02
claude mcp add --transport http supabase https://supabase.run.toolsWhat Supabase does
Supabase gives an agent tools for current documentation lookup, error investigation, and project administration. It can inspect organizations and projects, check creation costs, create or pause projects, and restore them. Database actions cover tables, extensions, migrations, raw SQL, logs, advisor notices, publishable keys, and generated TypeScript types.
The server can inspect and deploy Edge Functions, including retrieving their files. It also supports development branches with their own project references: an agent can create, list, reset, rebase, merge, or delete them. A new branch receives migrations from the main project, while production data stays out of it.
Project or branch creation requires a cost lookup with get_cost followed by user confirmation through confirm_cost. The MCP endpoint is https://supabase.run.tools. Setup commands are provided for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI.
What it helps with
- search current Supabase documentation
- inspect project logs and advisor notices
- apply migrations or run PostgreSQL SQL
- generate TypeScript database types
- create and merge a development branch
Example prompts for the agent
- Search the current Supabase docs for the migration approach needed by this project.
- Inspect this project’s logs and advisor notices, then explain the issues that need attention.
- Create a Supabase development branch, check its cost first, and prepare the changes for a production merge.
How to install Supabase
Platform CLI: remote server
claude mcp add --transport http supabase https://supabase.run.toolsPlatform CLI: remote server
codex mcp add supabase-supabase --url https://supabase.run.toolsConfig file
{
"mcpServers": {
"supabase-supabase": {
"url": "https://supabase.run.tools"
}
}
}Config file
{
"servers": {
"supabase-supabase": {
"type": "http",
"url": "https://supabase.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http supabase-supabase https://supabase.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Supabase
How do I install Supabase in Claude Code?
Run claude mcp add --transport http supabase https://supabase.run.tools, then run claude mcp add --transport http supabase-supabase https://supabase.run.tools.
What does the Supabase MCP server do?
It searches Supabase documentation and manages organizations, projects, databases, migrations, logs, keys, TypeScript types, and Edge Functions. It also handles development branches and their production merges.
Does a new Supabase branch include production data?
No. The branch receives migrations from the main project, but production data is not carried into it.
Similar MCP servers
All MCP servers for Backend and APIs →Supabase by other authors comes first.