Skip to content
skillsaggregatorskillsaggregator
Privacy: This guide links directly to Supabase's credential pages. We never ask you to enter, store, or transmit any credential through this site. Zero outbound calls to anything but the vendor's docs.

Supabase MCP — Auth Setup

Supabase uses a project URL and service role key (or personal access token) to authenticate server-side requests.

1. Get your credentials

  1. Open the Supabase API settings page for your project (opens Supabase — we never see your key)
  2. Copy the Project URL under "Project URL"
  3. Copy the service_role secret under "Project API keys" — or generate a personal access token for account-level access

2. Set environment variables

macOS / Linux — add to ~/.zshrc or ~/.bashrc:

export SUPABASE_URL=YOUR_PROJECT_URL_HERE
export SUPABASE_SERVICE_ROLE_KEY=YOUR_SERVICE_ROLE_KEY_HERE
# Or for personal access token auth:
# export SUPABASE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN_HERE

Then run source ~/.zshrc (or open a new terminal).

Windows — run in Command Prompt (then restart):

setx SUPABASE_URL "YOUR_PROJECT_URL_HERE"
setx SUPABASE_SERVICE_ROLE_KEY "YOUR_SERVICE_ROLE_KEY_HERE"

3. Verify

npx claude-skills doctor

You should see ✅ next to the Supabase MCP entry. If you see ❌, confirm the variables are set: echo $SUPABASE_URL.

4. Restart Claude Code

Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the Supabase MCP appears).