supabase-mcp-server
Author: alexander-zuev
Description: Query MCP enables end-to-end management of Supabase via chat interface (SQL execution, Management API, Auth Admin SDK, automatic migrations, safety layer, etc.).
Stars: 774
Forks: 93
License: Apache License 2.0
Category: Open Source
Overview
Installation
1. Clone the repo
git clone https://github.com/alexander-zuev/supabase-mcp-server.git && cd supabase-mcp-server2. Create and activate a Python virtual-environment (Python ≥3.9)
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate3. Install the package and its dependencies
pip install -r requirements.txt
# or, if the project is published on PyPI
pip install supabase-mcp-server4. Environment variables (minimum set)
SUPABASE_URL= # e.g. https://xyzcompany.supabase.co
SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY= # needed for management/migrations
OPENAI_API_KEY= # only if chat completion provider is OpenAI
MCP_AUTH_TOKEN= # arbitrary shared secret for protecting the endpoints5. Run database migrations (optional, enables version tracking)
python -m supabase_mcp_server migrate6. Start the server
python -m supabase_mcp_server # default port 8000
# or with uvicorn
uvicorn supabase_mcp_server.app:app --host 0.0.0.0 --port 80007. Verify
curl -H "Authorization: Bearer $MCP_AUTH_TOKEN" http://localhost:8000/healthzLicense: Apache License 2.0
Updated 7/30/2025