MCP server Official

Supabase MCP Server

Connect Supabase projects to AI assistants to manage tables, fetch config and query data.

Author
Supabase Community
Works with
Any MCP client, Cursor, Windsurf
License
Apache-2.0
Documented
Oct 2, 2026

What Supabase MCP Server is

Standardizes how LLMs talk to Supabase so assistants can manage tables, fetch config and query data. The hosted server is at https://mcp.supabase.com/mcp with OAuth login; local CLI and self-hosted setups expose a limited subset.

What it does

How Supabase MCP Server plugs in: which agents run it and what it addsRUNS INYour agentAny MCP clientCursorWindsurf3 hosts documentedMCP SERVER · OFFICIALSupabase MCP ServerConnect the agent to tools, data…4 install steps1 permission notelicense: Apache-2.0WHAT IT ADDSWhat it doesManage tables and schema in a Sup…Fetch project configurationQuery dataScope to one project with project…agent → extension → new capability · from the official repository or docs
Where Supabase MCP Server runs and what it adds, from its documentation
  • Manage tables and schema in a Supabase project
  • Fetch project configuration
  • Query data
  • Scope to one project with project_ref and read_only=true URL parameters
  • Filter tool groups with the features parameter

When to use it

Good fit

  • Developing against a Supabase project from Cursor, Claude or Windsurf
  • Read-only inspection of a project

Not for

  • Unreviewed production data: the README points to security risks of connecting an LLM to projects
  • Local CLI or self-hosted use needing full tools: only a limited subset and no OAuth 2.1

How to install Supabase MCP Server

You need: Supabase account; MCP client with remote HTTP support

  1. Read the Supabase security best practices first
  2. Add the server URL https://mcp.supabase.com/mcp to your MCP client
  3. Log in to Supabase when prompted and pick the right organization
  4. Optionally generate a project-specific URL in the dashboard MCP connection tab
Configuration example (from the official docs)
{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

Permissions and security

What it can access

  • Acts on your Supabase organization/projects as authorized at login; read_only and project_ref narrow it

Security notes from the maintainers

  • README recommends reading Supabase security best practices before setup

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • CLI and self-hosted servers offer a limited tool subset and no OAuth 2.1
  • Server does not send structuredContent in tool results

Tools it extends

No user reviews yet

AI coding IDE, formerly Windsurf, now Devin Desktop: manage local and cloud coding agents inside a full IDE.

Free stops at: Light quota for agent usage, resets daily and weekly, Limited model availability

Listed Not yet reviewed

Verified windsurf.com (opens Devin Desktop (formerly Windsurf) website in a new tab)

Frequently asked questions

How do I make Supabase MCP read-only?

Add read_only=true to the server URL, e.g. https://mcp.supabase.com/mcp?project_ref=&read_only=true. source

Where does the Supabase MCP server run?

Hosted at https://mcp.supabase.com/mcp; locally via Supabase CLI at http://localhost:54321/mcp with fewer tools. source

Is Supabase MCP the official server?

It is in the supabase-community org and linked from supabase.com docs; the README calls it the Supabase MCP Server. source

Related guides

Sources and gaps

Not stated by the maintainers: Official status inferred from supabase.com docs links, not an explicit statement; last_release date not visible in the checked README.

More extensions to look at