← Explore all 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.

“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.

Upstream setup instructions ↗
  1. Use the Supabase dashboard or official guide to create a project-scoped server URL.
  2. For exploration, enable read_only=true and limit features before completing OAuth.
  3. 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.

  1. Official documentation ↗Checked

    https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/README.md

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, configExample

  2. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/LICENSE

    Supports: license

  3. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/package.json

    Supports: language, review

  4. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/index.ts

    Supports: language, review

  5. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/database-operation-tools.ts

    Supports: review, limitations, access

  6. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/types.ts

    Supports: review

  7. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/account-tools.ts

    Supports: review, access

  8. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/branching-tools.ts

    Supports: review, access

  9. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/edge-function-tools.ts

    Supports: review, access

  10. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/secret-tools.ts

    Supports: review, access

  11. https://github.com/supabase/mcp/blob/3c3b1fce89c43324b316a76db6d9fb0cf475f344/packages/mcp-server-supabase/src/tools/storage-tools.ts

    Supports: review, access

Evidence & Ask