Supabase MCP Server

What you can do with Supabase MCP Server

Supabase's hosted MCP server connects an agent to your Supabase projects so it can query and migrate the Postgres database, read logs and advisors, deploy Edge Functions, manage branches and projects, and search the Supabase docs.

• ·List tables, extensions and migrations in a project
• ·Run SQL or apply named migrations
• ·Read project logs and security/performance advisors
• ·Generate TypeScript types and fetch project URL and keys
• ·Deploy and inspect Edge Functions
• ·Create, merge and reset development branches

What Supabase MCP Server can and cannot do

What you need before using Supabase MCP Server

Runtime

None; hosted remote at https://mcp.supabase.com/mcp (Supabase CLI for the local endpoint)

Credentials

OAuth sign-in to your Supabase organization; a scoped personal access token as a Bearer header for CI

Payment

Free with a Supabase account; branching needs a paid plan

Also needed

Optional URL parameters: project_ref, read_only=true, features, skip_elicitations

Connect Supabase MCP Server and confirm it works

1. Read Supabase's security best practices for connecting an LLM to a project
2. Add https://mcp.supabase.com/mcp as an HTTP server in your MCP client (or copy the project-specific URL from the dashboard's MCP tab)
3. Append ?project_ref=<ref>&read_only=true to scope and restrict the server
4. Sign in when prompted and choose the organization that holds your project

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

claude mcp add supabase -e "SUPABASE_ACCESS_TOKEN=<your SUPABASE_ACCESS_TOKEN>" -- npx -y @supabase/mcp-server-supabase

[mcp_servers.supabase]
url = "https://mcp.supabase.com/mcp"

[mcp_servers.supabase]
command = "npx"
args = ["-y", "@supabase/mcp-server-supabase"]

[mcp_servers.supabase.env]
SUPABASE_ACCESS_TOKEN = "<your SUPABASE_ACCESS_TOKEN>"

https://mcp.supabase.com/mcp

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

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

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

{
  "servers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

{
  "servers": {
    "supabase": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "<your SUPABASE_ACCESS_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "supabase": {
      "serverUrl": "https://mcp.supabase.com/mcp"
    }
  }
}

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

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

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

When to choose another server

• Neon#1,277

  Your managed Postgres is on Neon and you want its branch and project tools.

• Postgres MCP#724

  You run plain Postgres and want health checks and index tuning.

• MCP PostgreSQL Server#46,916

  You just need read-only SQL against any Postgres over a connection string.

Compared side by side in PostgreSQL MCP servers.

What changed, and when this was checked

First listed

Jan 20, 2025

Latest version published

Oct 14, 2026

Version history

20 versions tracked (below)

Requirements evidence

MCP Toplist probed the public endpoint on Oct 11, 2026 and could not complete the MCP handshake (jsonrpc error). Requirements remain unverified.

Profile checked

Oct 9, 2026 against Docs, README

Ranking data as of

Oct 16, 2026

Do you maintain Supabase MCP Server? Claim it to correct or enrich this profile.

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

[![MCP Toplist](https://mcptoplist.com/badge/com.supabase%2Fmcp.svg)](https://mcptoplist.com/server/com.supabase%2Fmcp)

<a href="https://mcptoplist.com/server/com.supabase%2Fmcp"><img src="https://mcptoplist.com/badge/com.supabase%2Fmcp.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.