---
title: "Supabase MCP Server Setup Guide and Schema"
slug: "supabase"
category: "databases"
package: "@supabase/mcp-server-supabase"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/supabase"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Supabase MCP Server

> Manage Supabase projects: database, auth, storage, and edge functions.

## Overview
Full Supabase platform management via MCP. Query PostgreSQL databases, manage authentication users, interact with storage buckets, deploy edge functions, and configure Row Level Security policies.

## Quick Install
```bash
npx -y @supabase/mcp-server-supabase
```

## Environment Variables

| Variable | Description | Required |
| :--- | :--- | :--- |
| `SUPABASE_ACCESS_TOKEN` | Supabase access token | **Yes** |

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "sbp_xxxxxxxxxxxx"
      }
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "sbp_xxxxxxxxxxxx"
      }
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.supabase]
command = "npx"
args = ["-y", "@supabase/mcp-server-supabase"]

[mcp_servers.supabase.env]
SUPABASE_ACCESS_TOKEN = "sbp_xxxxxxxxxxxx"
```

## Available Tools (5)

- `list_projects`
- `execute_sql`
- `list_tables`
- `apply_migration`
- `list_edge_functions`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/supabase
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/supabase-community/supabase-mcp