1. Home
  2. Supabase MCP Server
  3. Supabase MCP Server for Claude Code: Setup & Config

Data as of

Supabase MCP Server for Claude Code: Setup & Config

Connect Claude Code to Supabase projects for SQL, schema changes, debugging, and Edge Functions.

Supabase MCP Server Claude Code configuration

  1. Choose Claude Code configuration scope

    For Supabase MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add Supabase MCP Server to Claude Code

    Use the supabase-mcp entry below in mcpServers. Keep Supabase MCP Server's documented http connection fields and your other Claude Code entries.

  3. Check Supabase MCP Server in Claude Code

    Supabase MCP Server: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "supabase-mcp": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'supabase-mcp' '{"type":"http","url":"https://mcp.supabase.com/mcp"}'

Supabase in Claude Code: http checks

  • Inspect claude mcp list, then Supabase MCP Server's connection to mcp.supabase.com in /mcp. Complete Claude Code authentication only for a trusted service.
  • Supabase MCP Server: check http connectivity to mcp.supabase.com from Claude Code; a stdio command is not a replacement for this endpoint.
Catalog transports
stdio
Tools
search_docs, list_organizations, get_organization

Supabase MCP Server — details. Claude Code guide

Frequently asked questions

Register Supabase MCP Server with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's supabase-mcp example uses http. The Supabase MCP Server catalog lists stdio; these instructions follow the stored configuration instead.

Claude Code connects Supabase MCP Server to mcp.supabase.com using url.

Supabase MCP Server's stored list contains 33 tools, including search_docs, list_organizations, get_organization. Compare those names with Claude Code's connected tool list; the stored list is not a live check.