Set up Supabase MCP in Claude Code

Query your Supabase database, manage tables, run migrations, deploy edge functions, and manage branches directly from your AI editor.

Locate the config file

Claude Code reads MCP server configuration from the following file:

~/.claude.json

Create this file if it does not already exist.

Add the configuration

You can configure Supabase MCP using the CLI command or by editing the config file directly.

Option A: CLI command

bash

claude mcp add supabase-mcp -e SUPABASE_ACCESS_TOKEN=YOUR_SUPABASE_ACCESS_TOKEN -- npx -y @supabase/mcp-server-supabase

Option B: Config file

json

{
  "mcpServers": {
    "supabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "YOUR_SUPABASE_ACCESS_TOKEN"
      }
    }
  }
}

Set up environment variables

Supabase MCP requires the following environment variables:

SUPABASE_ACCESS_TOKENRequired

Supabase personal access token

Verify it works

Restart Claude Code. Supabase MCP should appear in your MCP server list with 25 tools available.

This server adds approximately 12,875 tokens to your context window for tool definitions.

Set up Supabase MCP in other editors

Cursor VS Code Windsurf Claude Desktop Continue

← Back to Supabase MCP