Supabase MCP Server

@supabase-community

About Supabase MCP Server

Connect Supabase to your AI assistants

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "sbp_03799d9799696a22107bda0918e527e9888b0fa3"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Supabase MCP Server?

The Supabase MCP Server connects your Supabase projects to AI assistants like Cursor, Claude, and Windsurf. It uses the Model Context Protocol (MCP) to let LLMs manage tables, fetch configuration, query data, and perform other Supabase tasks.

How to use Supabase MCP Server?

Configure your MCP client with the URL https://mcp.supabase.com/mcp and authenticate via OAuth. You can also use the Supabase CLI (local) or self‑hosted instances, though those have limited tools. Options like read_only, project_ref, and features are set as query parameters to restrict or customize tool access.

Key features of Supabase MCP Server

Tools grouped into account, database, knowledge base, debugging, development, edge functions, branching, and storage.
Read‑only mode restricts the server to non‑mutating queries.
Project‑scoped mode limits access to a single Supabase project.
Feature groups let you enable only the tools you need.
Supports OAuth 2.1 (cloud version) and works with most MCP clients.
Pre‑1.0 – breaking changes may occur between versions.

Use cases of Supabase MCP Server

Let an AI assistant manage Supabase projects (create, pause, restore).
Run SQL queries or apply migrations through natural language.
Search Supabase documentation for up‑to‑date guidance.
Deploy and manage Edge Functions from a chat interface.
Debug performance or security issues using logs and advisors.

FAQ from Supabase MCP Server

What tools are available?

Tools are grouped into account (project management), database (SQL, migrations), knowledge base (docs search), debugging (logs, advisors), development (keys, types), edge functions, branching (paid plan), and storage. Use the features parameter to select groups.

How do I restrict the server to read‑only operations?

Set the read_only=true query parameter. This disables all mutating tools and runs execute_sql as a read‑only Postgres user.

Can I limit the server to a single project?

Yes, set the project_ref query parameter to your project’s ID. This disables account‑level tools and scopes the server to that project.

Is the server available for local development?

Yes, when using the Supabase CLI locally, it’s available at http://localhost:54321/mcp but with a limited tool set and no OAuth.

What are the main security risks?

Connecting an LLM to your Supabase project carries risks. Supabase recommends reviewing their security best practices and using read‑only or project‑scoped mode by default.

Frequently asked questions

What tools are available?

How do I restrict the server to read‑only operations?

Set the `read_only=true` query parameter. This disables all mutating tools and runs `execute_sql` as a read‑only Postgres user.

Can I limit the server to a single project?

Yes, set the `project_ref` query parameter to your project’s ID. This disables account‑level tools and scopes the server to that project.

Is the server available for local development?

Yes, when using the Supabase CLI locally, it’s available at `http://localhost:54321/mcp` but with a limited tool set and no OAuth.

What are the main security risks?

Connecting an LLM to your Supabase project carries risks. Supabase recommends reviewing their security best practices and using read‑only or project‑scoped mode by default.

Comments

Basic information

More Cloud & Infrastructure MCP servers

Run Model Context Protocol (MCP) servers with AWS Lambda

awslabs

Run existing Model Context Protocol (MCP) stdio-based servers in AWS Lambda functions

373

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828

Mcp K8s Go

strowk

MCP server connecting to Kubernetes

383

GCP MCP

eniayomi

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Google Cloud Platform environment. This allows for natural language querying and management of your GCP resources during conversations.

200

Azure DevOps MCP Server

Tiberriver256

An MCP server for Azure DevOps

377