---
title: "Supabase MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/supabase/
description: "Connects an assistant to Supabase project data and configuration, with project, feature-group and read-only restrictions available in the server URL."
---

# Supabase MCP: review, setup & limitations · Undominated.ai

> Connects an assistant to Supabase project data and configuration, with project, feature-group and read-only restrictions available in the server URL.

[← Explore all mcp servers](/mcp-servers/)

DATABASE DEVELOPMENT / Supabase

# Supabase MCP

Connects an assistant to Supabase project data and configuration, with project, feature-group and read-only restrictions available in the server URL.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/supabase/mcp)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 11 linked sources
 Publisher Supabase
 Licence [Apache-2.0 ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/LICENSE)
 Revision 3c3b1fce89c4
 [Read what was—and wasn’t—checked ↓](#review)

“Connect your Supabase projects to Cursor, Claude, Windsurf, and other AI assistants.”

 [Supabase · upstream description ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Documents project scoping and feature selection alongside a read-only mode.
- Keeps hosted OAuth setup distinct from the reduced local and self-hosted tool surfaces.

### A good fit for

 - Exploring a development project’s schema and preparing database changes with an explicitly scoped connection.
- Embedding Supabase tools in a Vercel AI SDK app with typed schemas from createToolSchemas(), filtered to the same feature groups and read-only setting as the server URL.

### Weigh up before choosing

 - Read-only mode is opt-in; the standard connection includes mutating capabilities.
- Local CLI and self-hosted endpoints expose fewer tools and do not provide the hosted OAuth flow.
- The repository moved from supabase-community/supabase-mcp to supabase/mcp; the old GitHub URL answers 301 to https://github.com/supabase/mcp (checked 2026-10-13).
- The destructive-SQL confirmation in execute_sql and apply_migration is a regular-expression check on the SQL, applies only when the server enables it and the client can show forms, and is not a substitute for read_only=true.
- The package’s own HTTP handler (createSupabaseMcpHandler) rejects clients that speak only the 2025-era protocol with HTTP 400, per the README.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/package.json and src/index.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/types.ts and src/tools/*.ts (account, branching, database-operation, debugging, development, docs, edge-function, notebook, secret, storage, destructive-sql, confirmation) at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- LICENSE at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/tools/account-tools.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/tools/branching-tools.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/tools/edge-function-tools.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/tools/secret-tools.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344
- packages/mcp-server-supabase/src/tools/storage-tools.ts at 3c3b1fce89c43324b316a76db6d9fb0cf475f344

### Our findings

 - The createToolSchemas readOnly option defaults false and is not itself a permission boundary; server URL restrictions must match.
- The package exports an MCP server and HTTP handler, rather than establishing an interchangeable hosted/local feature set.
- The repository was transferred from supabase-community/supabase-mcp to supabase/mcp; GitHub redirects the old URL. The npm package name at this commit is still @supabase/mcp-server-supabase (version 0.13.0, Apache-2.0).
- src/types.ts lists nine feature groups: docs, account, database, debugging, development, functions, branching, storage, notebooks. The tool files define, among others, execute_sql, apply_migration, deploy_edge_function, create_edge_function_secret, update_storage_config, create_project, pause_project, restore_project and delete_branch, merge_branch, reset_branch, rebase_branch.
- execute_sql and apply_migration can ask the user to confirm SQL that matches DROP, DELETE, TRUNCATE or UPDATE without WHERE, through an MCP form; create_project and create_branch require a cost confirmation first: a server form, or a confirm_cost_id obtained through get_cost and confirm_cost.
- configExample is the README’s generic mcpServers block at this commit; the README says the client prompts for a Supabase login during setup.

### Not established by this review

 - Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md)
 - Use the Supabase dashboard or official guide to create a project-scoped server URL.
- For exploration, enable read_only=true and limit features before completing OAuth.
- Use the official URL builder for the intended project; copy its project_ref/read_only/features settings into your client’s own configuration format.

### Before you start

 - A Supabase account and permission to the intended project.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "supabase": {
 "type": "http",
 "url": "https://mcp.supabase.com/mcp"
 }
 }
} Copy configuration ↗

### Compatibility

An MCP client supporting Streamable HTTP. · A Supabase account and permission to the intended project.

### Implementation

TypeScript

### Transports

Streamable HTTP

### Database development / Remote service

 - Reads project schema, data and configuration.
- Unrestricted tool groups can change database objects and project state: run SQL, apply migrations, deploy Edge Functions, set Edge Function secrets, change storage configuration, create, pause or restore projects, and create, merge, reset or delete branches.
- Hosted access uses an OAuth login to a Supabase organization, prompted by the client; a server URL with project_ref scopes it to one project, and the README says such a server excludes account-level tools.

### Cost model

Supabase project and service usage determine cost; the source licence does not cover hosted service usage.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Official documentation ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, configExample
- [Applicable source licence ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/LICENSE) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/LICENSE Supports: license
- [Implementation: packages/mcp-server-supabase/package.json ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/package.json) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/package.json Supports: language, review
- [Implementation: packages/mcp-server-supabase/src/index.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/index.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/index.ts Supports: language, review
- [Implementation: packages/mcp-server-supabase/src/tools/database-operation-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/database-operation-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/database-operation-tools.ts Supports: review, limitations, access
- [Implementation: packages/mcp-server-supabase/src/types.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/types.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/types.ts Supports: review
- [Supabase MCP account-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/account-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/account-tools.ts Supports: review, access
- [Supabase MCP branching-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/branching-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/branching-tools.ts Supports: review, access
- [Supabase MCP edge-function-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/edge-function-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/edge-function-tools.ts Supports: review, access
- [Supabase MCP secret-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/secret-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/secret-tools.ts Supports: review, access
- [Supabase MCP storage-tools.ts ↗](https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/storage-tools.ts) Checked 2026-10-13 https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/storage-tools.ts Supports: review, access

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Neon MCP Server ↗ Manages Neon Postgres projects, branches and SQL through a hosted connection with project and grant-based tool filtering.](/mcp-servers/neon/)[### Aurora DSQL MCP ↗ AWS Labs MCP server that turns questions into Postgres-compatible SQL for Aurora DSQL, read-only unless --allow-writes is passed, and only on the same host as the client.](/mcp-servers/awslabs-aurora-dsql/)[### Aurora MySQL MCP ↗ AWS Labs MCP server that turns natural language into SQL for Aurora MySQL on the same host as the client, with a keyword guard the README says is not a security boundary.](/mcp-servers/awslabs-mysql/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
