# Supabase MCP

> Supabase's own MCP server: your agent manages tables, runs SQL and migrations, checks logs and deploys Edge Functions in your projects.

Supabase's own MCP server connects your agent to your Supabase projects. Once it's connected, your agent can manage tables, write and apply migrations, query data, check logs and advisors, and deploy Edge Functions for you, and search Supabase's docs as it works.

What you can do with it
- List tables, extensions and migrations, apply migrations and run SQL
- Query your project's logs and get its security and performance advisors
- Get a project's API URL and publishable keys, and generate TypeScript types from your schema
- List, read and deploy Edge Functions
- List, create, pause and restore projects, and look up organizations
- Create, merge, reset and rebase development branches (experimental, on paid plans)
- Search the Supabase documentation

How it connects
Supabase hosts it at https://mcp.supabase.com/mcp. The first time your agent uses it, a browser window opens so you can sign in to Supabase and choose the organization it can reach; you don't need a personal access token. For CI, where a browser sign-in isn't possible, pass a personal access token as a bearer token instead. If you run Supabase locally with the Supabase CLI, the server is at http://localhost:54321/mcp, with fewer tools and no OAuth.

Choose what it can do
Add options to the address. read_only=true runs every query as a read-only Postgres user, project_ref=<your project ref> limits it to one project (and turns off the account tools), and features=database,docs keeps only the tool groups you name. The groups are docs, account, database, debugging, development, functions, branching and storage; storage is off unless you add it. For example: https://mcp.supabase.com/mcp?project_ref=<your project ref>&read_only=true

Good to know
Supabase recommends using it as a developer tool, not giving it to your customers, and keeping production data out of reach: scope it to one project, turn on read-only mode, work on a development branch and review each tool call before it runs. Where your agent supports it, the server asks you to confirm the cost before it creates a project or branch, and to confirm SQL it detects as destructive.

- Type: Plugin
- Made by: Supabase
- Category: Databases
- Formats: Remote MCP, Local MCP
- Version: 0.14.0
- Website: https://supabase.com/docs/guides/ai-tools/mcp
- Source: https://github.com/supabase/mcp/tree/HEAD/packages/mcp-server-supabase
- Page: https://pluginboard.ai/plugins/supabase-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.supabase.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.supabase.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.supabase.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.supabase.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.supabase.com/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.supabase.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22supabase-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.supabase.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http supabase-mcp https://mcp.supabase.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=supabase-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5zdXBhYmFzZS5jb20vbWNwIn0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "supabase-mcp": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http supabase-mcp https://mcp.supabase.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add supabase-mcp --url https://mcp.supabase.com/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "supabase-mcp": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http supabase-mcp https://mcp.supabase.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.supabase.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add supabase-mcp --url https://mcp.supabase.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.supabase.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login supabase-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add supabase-mcp --url https://mcp.supabase.com/mcp
```

If it needs a key: For https://mcp.supabase.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add supabase-mcp --url https://mcp.supabase.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "supabase-mcp": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.supabase.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).