Supabase MCP Server

Official

Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.

Remote serverstreamable-httpTypeScriptApache-2.0★ 2.2k

What is the Supabase MCP Server?

Supabase MCP connects an assistant to Supabase project tools, including database exploration and documentation. It is useful for understanding tables before writing a query or investigating a project problem.

Scope the connection to the project

The hosted service uses https://mcp.supabase.com/mcp and supports OAuth sign-in. Add project_ref to select a project. Supabase also documents read_only=true and the features parameter for limiting the exposed tool groups. The example below starts with database and documentation access in read-only mode.

Inspect the schema before querying

Ask which tables and columns relate to your question, then request a bounded query. Keep the SQL with the answer so the result can be reproduced. Migration tools belong to a separate change workflow; their presence does not mean a schema change is needed to answer a data question.

Setup and tool documentation. Explore related MCP servers.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_tablesInspect the project’s database tables.
execute_sqlRun SQL subject to the configured access mode.
search_docsSearch Supabase documentation.

How to install the Supabase MCP Server

{
  "mcpServers": {
    "supabase": {
      "url": "https://mcp.supabase.com/mcp?project_ref=YOUR_PROJECT_REF&read_only=true&features=database,docs"
    }
  }
}

Replace YOUR_PROJECT_REF and complete OAuth. This configuration requests read-only database and documentation tools.

Configuration

A Supabase account, the intended project reference and an HTTP MCP client with OAuth support.

Example prompts to try

  • “Inspect the tables in this project and propose a read-only query for weekly signups.”

Frequently asked questions

Yes. The hosted connection supports the project_ref parameter.