claudekit / tools / supabase
[ MCP · Development ]

Supabase

Supabase's official MCP server. List tables, run SQL, apply migrations, generate TypeScript types, and deploy edge functions from Claude Code.

$ claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true" --header "Authorization: Bearer YOUR_ACCESS_TOKEN" copy

Supabase’s official MCP server (supabase-community/supabase-mcp).

Why it matters

Checking schema, running queries, and applying migrations meant the Supabase dashboard or CLI. Connect the Supabase MCP and you can do database and backend work as a conversation in Claude Code.

What you can do

Representative tasks from Supabase’s official docs:

  • List tables and schema — “List all tables and show the schema of the users table.”
  • Run SQL — “Run this query against my project and summarize the results.”
  • Apply migrations — “Create a migration that adds a created_at column to the orders table and apply it.”
  • Generate TypeScript types — “Generate TypeScript types for my database schema.”
  • Debug — “Fetch the recent service logs and the security advisor warnings.”
  • Deploy edge functions — “Deploy this edge function to my project.”

Grounded in supabase.com/docs/guides/getting-started/mcp.

Key features

  • Databaselist_tables, execute_sql, apply_migration, list_migrations
  • Developmentgenerate_typescript_types, get_project_url, get_publishable_keys
  • Debuggingget_logs, get_advisors
  • Edge functionslist_edge_functions, deploy_edge_function
  • Branching, storage, docs search (search_docs)

Setup

Remote (recommended):

claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true" --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Local:

claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest --read-only --project-ref=YOUR_REF --access-token=YOUR_TOKEN

Notes

  • Auth — pass a personal access token (PAT) via an Authorization: Bearer header or --access-token (OAuth login is also supported)
  • Use --read-only (or read_only=true) when connecting to a production database
  • License — Apache 2.0 (supabase-community/supabase-mcp, canonical supabase/mcp)
  • Also available as an official Claude connector (paid Claude plans)
§ 6

See also

same category · curated
[01]
[Plugin] gstack · Garry Tan's (YC CEO) exact Claude Code setup, packaged as slash commands. Call up roles like CEO, Designer, Eng Manager, QA, and Release Manager in sequence so a solo builder can work like a team.
tool · claudekit.io / tools / gstack
[02]
[MCP] PayPal · PayPal's official remote MCP server and open-source Agent Toolkit. Create invoices, orders, payments, refunds, subscriptions, and handle disputes from Claude Code.
tool · claudekit.io / tools / paypal
[03]
[MCP] Shopify Dev MCP · Shopify's official MCP server. Search Shopify dev docs, introspect the Admin GraphQL schema, and validate GraphQL, Liquid, and component code from Claude Code.
tool · claudekit.io / tools / shopify
§ 7

Frequently Asked Questions

frequently asked
§ 7.1
What is the Supabase MCP?
Supabase's official MCP server (`supabase-community/supabase-mcp`). It lets Claude Code list tables, run SQL, apply migrations, generate types, and deploy edge functions against your project.
§ 7.2
Where does it work?
It works in Claude Code and Claude Desktop. The remote HTTP server (`mcp.supabase.com/mcp`) is recommended, with a local npx package (`@supabase/mcp-server-supabase`) also available.
§ 7.3
How do I install it?
For remote, run `claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true"` and pass a personal access token via an `Authorization: Bearer` header. For local, pass `--access-token` and `--project-ref` to the npx package.
§ 7.4
What can I do with it?
List tables, run SQL, apply migrations, generate TypeScript types, fetch logs and security advisors, and deploy edge functions. For example: "List all tables and show the schema of the users table."
§ 7.5
How do I use it safely?
Use `--read-only` (or `read_only=true`) when connecting to a production database. The license is Apache 2.0.