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.
“Connect your Supabase projects to Cursor, Claude, Windsurf, and other AI assistants.”
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.
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.
- 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"
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Official documentation ↗Checked
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, configExample
- Applicable source licence ↗Checked
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/LICENSE
Supports: license
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/package.json
Supports: language, review
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/index.ts
Supports: language, review
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/database-operation-tools.ts
Supports: review, limitations, access
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/types.ts
Supports: review
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/account-tools.ts
Supports: review, access
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/branching-tools.ts
Supports: review, access
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/edge-function-tools.ts
Supports: review, access
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/secret-tools.ts
Supports: review, access
https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/storage-tools.ts
Supports: review, access