Supabase MCP server

The Supabase MCP server gives AI agents access to your Supabase projects: list tables, run SQL, apply migrations, read logs and advisors, deploy edge functions, manage branches and search Supabase docs.

Checked by CookiesForAI on : repository facts (stars, last push, archived) re-read from GitHub; listing in the MCP Registry checked.

Written by

Connect Supabase

Claude Code, project config (then run claude /mcp and choose Authenticate)

Terminal
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"

Codex (then run codex mcp login supabase)

Terminal
codex mcp add supabase --url "https://mcp.supabase.com/mcp"

Gemini CLI

Terminal
gemini mcp add -t http supabase "https://mcp.supabase.com/mcp"

Cursor, VS Code and most clients

Config
{"mcpServers": {"supabase": {"type": "http", "url": "https://mcp.supabase.com/mcp"}}}

Append ?project_ref=<id>&read_only=true to the URL to limit the agent to one project with read-only SQL. The connection tab in the Supabase dashboard builds a custom URL for your project.

Or paste this into your coding agent: Connect the Supabase MCP server to my coding agent using its documented setup: https://github.com/supabase/mcp. Checked by CookiesForAI on : repository facts (stars, last push, archived) re-read from GitHub; listing in the MCP Registry checked.

What the Supabase MCP server does

The Supabase MCP server connects an AI agent to Supabase, the Postgres-based backend platform. Through it an agent can list your projects and tables, run SQL, write and apply migrations, list extensions, generate TypeScript types from the schema, and read the security and performance advisors. It can also read logs, deploy edge functions, fetch project URLs and keys, and search Supabase's documentation.

Supabase's server ties into its development branches: an agent can create a branch database, test a migration there and merge it back, which keeps experiments off production. URL parameters narrow what the agent can reach: project_ref limits it to one project, read_only=true runs SQL as a read-only Postgres user, and features picks tool groups such as database or docs. Supabase also wraps SQL results with instructions meant to discourage the model from following commands hidden in your data.

Supabase hosts the server at mcp.supabase.com with OAuth sign-in, and a local Supabase CLI stack serves a smaller tool set at localhost:54321/mcp. The open-source package also lets you serve the tools from your own endpoint. The GitHub repo had 2,925 stars on .

Tools it gives your agent

  • list_projects
  • list_tables
  • execute_sql
  • apply_migration
  • list_migrations
  • list_extensions
  • get_advisors
  • generate_typescript_types
  • deploy_edge_function
  • create_branch
  • merge_branch
  • search_docs

We also list this company's other pages: Supabase product page and 2 skills by Supabase.

When to use Supabase

  • You build on Supabase and want the agent to design tables and write migrations against the real schema.
  • You want the agent to read the security advisor and fix missing row level security policies.
  • You need to deploy or debug an edge function from your editor.
  • You want schema experiments to happen on a branch database, not on production.

When to pick something else

  • Giving to customers or end users: Supabase warns the server runs with your developer permissions.
  • Production data with full access: prompt injection in stored data could trick the agent into harmful queries, so use read_only=true and project_ref there.

What Supabase needs

  • A Supabase account (OAuth sign-in on first use)

What the Supabase MCP server costs

The server costs nothing extra and is open source under Apache-2.0; it works with any Supabase plan, including the Free plan.

Current prices: supabase.com . We do not list prices because vendors change them often. Check the publisher's own page.

Questions people ask

Is the Supabase MCP server free?

Yes. The server has no separate price and works on Supabase's Free plan; you pay only if you move to a paid Supabase plan (pricing page, ).

Can the Supabase MCP server write to my database?

Yes by default: it can run any SQL, apply migrations and deploy functions. Add read_only=true to the URL to run queries as a read-only Postgres user and drop the mutating tools.

Does the Supabase MCP server work with ChatGPT?

Yes. Supabase's setup docs list ChatGPT and Claude.ai among web clients, along with Codex, Claude Code, Cursor, VS Code, Gemini CLI and Grok.