Supabase
Free foreverSupabase · Productivity
6.9k installs
The Supabase MCP server brings your Supabase organizations, projects, Postgres databases, and Edge Functions into one hosted MCP endpoint that any AI agent — Claude, GPT, or Gemini — can call without custom integration work. Instead of hand-rolling API clients or copy-pasting docs into a chat window, teams connect Supabase once through BusinessMCP and immediately give every agent in their stack the ability to search current Supabase documentation, inspect schemas, run queries, manage projects, and troubleshoot errors in real time. Because BusinessMCP is model-agnostic, this works identically whether your agent runtime is Claude Desktop, a custom GPT, or an internal Gemini-based workflow — the underlying MCP tools don't change.
For engineering and platform teams, this Supabase MCP server acts as a live documentation and operations layer. Rather than relying on stale training data or manually searching supabase.com/docs, an agent can query the docs tool directly to pull accurate, current guidance on Postgres extensions, Row Level Security policies, authentication flows, storage buckets, or Edge Function deployment — then apply that guidance immediately by executing the relevant management action. This is especially useful for debugging production incidents: an agent can search for an error message, cross-reference it against the latest Supabase changelog-aware docs, and then inspect the actual project configuration to confirm the fix, all inside one conversational flow instead of tab-switching between a dashboard, docs site, and terminal.
Operationally, the server exposes organization and project management alongside database and Edge Function control, so it suits a range of jobs: scaffolding a new Supabase project for a client engagement, auditing which projects belong to which organization before a billing review, running ad-hoc SQL to validate data before a migration, or deploying and updating Edge Functions as part of an agent-driven CI step. Because it's hosted through BusinessMCP's unified /api/mcp endpoint with a Bearer mcph_* key, you're not standing up and maintaining a separate MCP process per tool — Supabase sits alongside your other connected systems (docs, project trackers, storage, ad platforms) behind one authenticated surface, which simplifies both security review and agent configuration.
This pairs naturally with BusinessMCP's business-intelligence dashboard: usage of the Supabase MCP tools — which projects get queried most, how often docs lookups precede a database change, where troubleshooting time concentrates — rolls up into the same reporting layer as your other connected tools, rather than living in a Supabase-only silo. That's useful for teams trying to understand where AI agents are actually saving engineering time versus where they're generating noisy queries. And because the integration is cookieless and GDPR-friendly by design, it's a reasonable fit for teams in regulated environments who still want agent-driven database and documentation search without adding a new tracking surface.
In practice, teams reach for this Supabase integration when they want an agent to be a genuinely capable first responder for backend issues — not just a chatbot that repeats generic Postgres advice, but one that can look up the specific Supabase behavior, check the actual project state, and take a corrective action like running a query or redeploying a function, all through a single hosted MCP connection.
Just say it in a thread
No configs, no docs. Once connected, these are the kinds of messages your agents act on.
"How many rows are in the profiles table of the production project, and how many were created this week?"
"Search the Supabase docs for how to set up row-level security on a multi-tenant table."
"List all my Supabase projects and tell me which region each one runs in."
"Add a referral_code text column to the users table in the staging project."
"Deploy the updated send-welcome-email Edge Function to production."
"Run a query to find users who signed up but never created a workspace."
"Compare the orders table schema between staging and production and list any differences."
"Create a new Supabase project for our QA environment."
"I'm seeing 'JWT expired' errors — search the docs for likely causes and check my project's settings."
"List the organizations my account can access and the projects under each."
What teams use it for
- Agent searches current Supabase docs to resolve a specific error before making a database change
- Automated project audit across multiple Supabase organizations for billing or access review
- Ad-hoc SQL queries run by an agent to validate data prior to a schema migration
- Deploying or updating an Edge Function as part of an agent-driven release workflow
- First-line troubleshooting where an agent diagnoses a Postgres or RLS issue using live docs plus project inspection
Agent-callable tools
search_supabase_docs
Search current Supabase documentation for guidance on a feature, API, or error message.
list_projects
List all Supabase projects available under a given organization.
get_project_details
Retrieve configuration, status, and metadata for a specific Supabase project.
execute_sql_query
Run a SQL query against a specified Supabase Postgres database and return results.
list_organizations
List the Supabase organizations accessible to the authenticated account.
deploy_edge_function
Deploy or update a Supabase Edge Function for a given project.
manage_database_schema
Inspect or modify tables, columns, and relationships within a project's database schema.
create_project
Provision a new Supabase project within a specified organization.
Your data stays yours
Credentials live in your vault. We route requests — we never store, log, or train on your data.
Works with every AI
Connect once — portable across Claude, GPT, Gemini, and every local agent you run.
Pairs well with
Best Productivity MCP serversAirtable
airtable
Spreadsheet-database hybrid for structured data. Create, read, update records and manage bases programmatically.
Zapier
zapier
Connect 8,000+ apps through Zapier automations. Trigger workflows, manage zaps, and automate repetitive tasks.
Fetch
anthropic
Web content fetching with robots.txt compliance. Retrieve and convert web pages to markdown for AI consumption.
Filesystem
anthropic
Secure file operations with configurable access controls. Read, write, move, and search files with directory restrictions.
Notion
Notion Labs
Read and write pages, databases, and docs from any agent thread.
Frequently asked questions
What can the Supabase MCP server actually do?
It lets an AI agent search up-to-date Supabase documentation, manage organizations and projects, inspect and query the underlying Postgres database, and deploy or manage Edge Functions, all through one hosted MCP connection.
Does this replace the Supabase dashboard?
No — it's designed to sit alongside it, giving agents programmatic access to the same project, database, and function management capabilities so routine or investigative tasks can be handled conversationally.
How does this fit with BusinessMCP's other connected tools?
Supabase is exposed through the same unified /api/mcp endpoint and Bearer key as your other connected systems, so usage and troubleshooting activity show up alongside them in the shared business-intelligence dashboard instead of a separate silo.
Why do my SQL queries fail with permission or RLS errors?
Queries run with the credentials you connected. If row-level security is enabled on a table and you connect with a non-service role, RLS policies filter or block rows exactly as they would for that user. Decide deliberately: use a service-role connection for admin analytics, or keep RLS in force when you want the agent to see only what a given role could see.
Is it safe to let an agent run schema changes on production?
Treat it like any migration path: point the connection at a staging project first, review the SQL the agent proposes before it runs, and only promote changes you have verified. The server executes exactly what is asked — the safety comes from which project you connect and what you approve.
Why isn't my Edge Function deploying?
Check three things: the project ref and function name must match an existing (or intended) function exactly, the function code must pass bundling — a syntax error fails the deploy — and your account needs sufficient rights on the project. The built-in docs search is useful here: ask the agent to look up the exact deploy error message.
Keep exploring
Give your AI team the Supabase skill
Free forever plan, no credit card. Connected and working in under five minutes.
Connect Supabase free