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

L

Lium - GPU cloud

Lium

Find, price and rent GPUs on Lium from Claude, ChatGPT, Codex or any MCP client. Search live GPU availability and prices (H100, H200, B200, RTX 4090 and more), estimate provider earnings, and with Sign in with Lium or a

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828

🐋 Docker MCP server

ckreiling

MCP server for Docker

726

MCP Gateway

mcp-ecosystem

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

2.2K

monadomain-mcp

themonagroup

Buy .vn and 371 international domains in VND inside Claude Code, Codex or Cursor. Search and reserve as a guest, pay by VietQR, sign in with MONA Pass once to claim; the agent then points DNS and SSL at your app. Alias o

Advertise