Advertise
MCP.so
Sign In
S

Supabase MCP Server

@medieage

Repository

Basic information

Category

Cloud & Infrastructure

Transports

stdio

Author

medieage

Submitted by

Frozenvile

About Supabase MCP Server

No overview available yet

#supabase#mcp#database-management

Supabase MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "supabase-mcp-server-medieage": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "supabase-mcp-server"
      ]
    }
  }
}

Supabase MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Supabase MCP Server?

Supabase MCP Server is an MCP server that enables your favorite IDE to safely execute SQL queries, manage your database end-to-end, access the Supabase Management API, and handle user authentication—all with built-in safety controls. It is designed for developers using Cursor, Windsurf, Cline, or any MCP client that supports the stdio protocol.

How to use Supabase MCP Server?

Install the server via pipx install supabase-mcp-server or uv pip install supabase-mcp-server, then configure it with environment variables or a global .env file. The server requires a Supabase project reference, database password, and optionally an access token and service role key for Management API and Auth Admin features.

Key features of Supabase MCP Server

  • Compatible with Cursor, Windsurf, Cline, and other MCP clients
  • Read-only and read-write SQL execution modes
  • Runtime SQL query validation with risk level assessment
  • Three-tier safety system: safe, write, and destructive
  • Robust transaction handling for direct and pooled connections
  • Automatic versioning of database schema changes

Use cases of Supabase MCP Server

  • Execute SQL queries against a Supabase database from your IDE
  • Manage Supabase projects via the Management API
  • Handle user authentication with the Auth Admin SDK
  • Safely alter database schemas with built-in safety controls
  • Manage database schema changes with automatic versioning

Frequently asked questions

1

What are the runtime dependencies?

Python 3.12 or later is required. PostgreSQL libraries are no longer needed because the server uses `asyncpg`. For local Supabase instances, PostgreSQL 16+ must be installed separately.

2

How does the server connect to the database?

It connects to your Supabase PostgreSQL database using the transaction pooler endpoint. For remote projects, the connection string is built from the project reference, password, and region. Session pooling is not supported; only transaction pooling is used.

3

Where does configuration data live?

Configuration is read from environment variables, a local `.env` file (when running from source), or a global config file at `~/.config/supabase-mcp/.env` on macOS/Linux or `%APPDATA%\supabase-mcp\.env` on Windows.

4

What are the known limitations?

The server does not support self-hosted Supabase instances, custom connection strings, or session pooling. Management API and Auth Admin features only work with remote Supabase projects, not local development.

5

How does authentication work?

The server uses environment variables for authentication. `SUPABASE_DB_PASSWORD` is required for database access. `SUPABASE_ACCESS_TOKEN` enables the Management API, and `SUPABASE_SERVICE_ROLE_KEY` enables the Auth Admin SDK. All connections are made over `stdio` transport.

Comments

More Cloud & Infrastructure MCP servers

Dockhold

dockhold

Put the project you are working on online. Deploys the current folder or a GitHub repo to a live HTTPS URL on Dockhold; reads status and logs, sets variables, resizes apps and databases...

Nippy

Nippy

Nippy is drag-and-drop hosting (nippy.host) with an MCP server: connect it and your assistant can publish HTML, folders of photos, or file downloads to a live *.nippy.site URL — and keep editing the site in place at the

HostingFor.AI

J. Klassen Inc.

Web hosting for websites built with AI. Connect your HostingFor.AI account and your AI assistant can publish and maintain your site directly: upload files, manage DNS records for custom domains, run SQL against your MySQ

Webshare

Webshare

The official Webshare MCP server. Manage your proxies, usage, plans and billing from Claude, Cursor or any MCP client. Sign in with OAuth, no API key.

OutageDeck

outagedeck

Official OutageDeck MCP server for vendor-published cloud and SaaS status, incident timelines, and observed uptime history.

Advertise