# Supabase

This MCP server lets an agent search Supabase docs and manage projects, databases, migrations, Edge Functions, and development branches.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 177 installs
- Author: supabase
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/Supabase
- Updated: 2025-10-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/supabase-supabase

## What it 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.

## Requirements
- Remote server: `https://supabase.run.tools`
- Works with: Supabase

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http supabase https://supabase.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add supabase-supabase --url https://supabase.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "supabase-supabase": {
            "url": "https://supabase.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "supabase-supabase": {
            "type": "http",
            "url": "https://supabase.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http supabase-supabase https://supabase.run.tools
```

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

## Similar
- [supabase-development](https://affpapa.org/en/nevibecode/skills/supabase-development.md) — skill · 740 installs
- [supabase-cost-tuning](https://affpapa.org/en/nevibecode/skills/supabase-cost-tuning.md) — skill · 1 install
- [supabase-cli](https://affpapa.org/en/nevibecode/skills/supabase-cli.md) — skill · ★ 1216 repo stars
- [supabase-server](https://affpapa.org/en/nevibecode/skills/supabase-server.md) — skill · 11200 installs
- [crontap-supabase-edge-function-cron](https://affpapa.org/en/nevibecode/skills/crontap-supabase-edge-function-cron.md) — skill · 1300 installs
- [supabase-realtime-optimizer](https://affpapa.org/en/nevibecode/agents/supabase-realtime-optimizer.md) — subagent · 1346 installs

## Other versions with the same name
- [Supabase · supabase](https://affpapa.org/en/nevibecode/mcp/supabase.md) — ★ 3022 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
