Supabase MCP server

Supabase's official remote server for managing projects, running SQL, applying migrations, reading logs and searching Supabase docs. Your client prompts you to sign in through OAuth.

Remote (HTTP)OAuth

Set up Supabase

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

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

Cursor

Merge into ~/.cursor/mcp.json

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

Codex

Run in your terminal.

codex mcp add supabase --url https://mcp.supabase.com/mcp
codex mcp login supabase

Gemini CLI

Merge into ~/.gemini/settings.json

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

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "supabase": {
      "type": "remote",
      "url": "https://mcp.supabase.com/mcp",
      "enabled": true
    }
  }
}

VS Code

Merge into .vscode/mcp.json

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

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.

Overview

Supabase maintains its MCP server in the supabase/mcp repository. Version 0.13.0 of the server package was released on 17 September 2026, and the repository had commits in October. Supabase hosts it at https://mcp.supabase.com/mcp, and the same server is available locally through the Supabase CLI.

The database tools include list_tables and list_extensions to inspect a schema, execute_sql to run queries, and list_migrations and apply_migration to track and change the schema. get_logs and get_advisors help with debugging and security or performance checks, and search_docs searches Supabase's documentation. Further feature groups cover account management, branching, Edge Functions and storage.

When you add the URL, your MCP client prompts you to sign in to Supabase through OAuth. Choose the organization that contains the project you want. Upstream strongly suggests narrowing what the agent can reach. Add project_ref to scope the server to one project, read_only=true to remove mutating tools, and features to enable only the groups you need. For example: ?project_ref=<ref>&read_only=true&features=database,docs. Treat any connection with write access to a production database with care, and prefer a development project or branch.

Example tools

  • list_tables
  • execute_sql
  • apply_migration
  • list_migrations
  • get_logs
  • search_docs

Tool names are upstream examples. The server's live tool list can differ.

Browse Database servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.