Skip to main content

Supabase MCP Server: How to Connect Supabase to Claude, Cursor & Any AI Agent

· 4 min read
Tony Lewis
MCPBundles
Ask AI:
PerplexityClaudeChatGPTGoogleGrok

Supabase MCP Server

Supabase ships an official MCP server that gives your AI access to the full Supabase platform — Postgres databases, authentication, storage, edge functions, and project management. It's one of the more complete official MCP implementations, covering both development workflows and production operations.

This guide covers what the Supabase MCP server offers, how to set it up, and how to access it through MCPBundles alongside your other tools.

What the Supabase MCP Server Covers​

Supabase's MCP server is broad because Supabase itself is broad — it's an entire backend platform, not just a database.

Database (Postgres)​

  • Run SQL queries — SELECT, INSERT, UPDATE, DELETE against your Supabase Postgres database.
  • Manage tables — Create, alter, and drop tables through your AI.
  • Schema inspection — List tables, columns, types, and relationships.
  • Migrations — Generate and apply database migrations.

Authentication​

  • Manage users — List, create, and manage auth users.
  • Auth configuration — View and update auth settings.

Storage​

  • Manage buckets — Create and configure storage buckets.
  • File operations — Upload, download, list, and delete files.

Edge Functions​

  • Deploy functions — Create and update edge functions.
  • Function management — List, inspect, and manage serverless functions.

Project Management​

  • Project settings — View and update project configuration.
  • API keys — Access project API keys and connection strings.
  • Logs — Query project logs for debugging.

Setup Options​

Option 1: Direct Connection (npm)​

Install and run the official Supabase MCP server locally:

npx supabase mcp

Or add to your MCP client configuration:

Claude Desktop:

{
  "supabase": {
    "command": "npx",
    "args": ["-y", "@supabase/mcp-server"],
    "env": {
      "SUPABASE_ACCESS_TOKEN": "your-access-token"
    }
  }
}

Claude Code:

claude mcp add supabase -- npx -y @supabase/mcp-server

You'll need a Supabase access token from your project settings.

Option 2: Through MCPBundles​

MCPBundles hosts the Supabase MCP server alongside 500+ other tools. No npm install, no local process management.

  1. Enable Supabase on MCPBundles
  2. Connect with your Supabase credentials
  3. Supabase tools appear alongside all your other MCP tools

Useful when you're working across multiple services — your AI has Supabase, Stripe, GitHub, and everything else through one connection.

Real Workflows​

"Create a users table with email, name, and created_at"

Your AI generates the SQL, creates the table, and sets up appropriate indexes. No pgAdmin or SQL editor needed.

"What tables exist in my database and how are they related?"

Schema inspection across all tables. Your AI maps foreign keys, identifies relationship patterns, and gives you a clear picture of your data model.

"Deploy an edge function that sends a welcome email on user signup"

Your AI writes the function, deploys it to Supabase Edge Functions, and confirms it's running. End-to-end from prompt to production.

"Show me all users who signed up in the last 7 days"

SQL query against the auth users table, filtered by creation date. Your AI formats the results and highlights trends.

"Set up a storage bucket for user avatars with a 5MB size limit"

Bucket creation with size limits and access policies. Your AI configures the bucket and generates the client-side upload code.

FAQ​

Is this the official Supabase MCP server?​

Yes. Supabase maintains the official MCP server as an npm package (@supabase/mcp-server). MCPBundles provides hosted access to the same capabilities without running a local process.

Does this give full database access?​

Yes. Your AI can run any SQL against your Supabase Postgres database — reads and writes. Use with appropriate caution on production databases.

Can my AI deploy edge functions?​

Yes. The MCP server supports creating, updating, and managing Supabase Edge Functions directly from your AI client.

Do I need to run anything locally?​

With MCPBundles, no. The server runs hosted. If you prefer running locally, npx @supabase/mcp-server works with Claude Desktop, Cursor, and other MCP clients.