mcp-registry/supabase-mcp-server

    ==================
      
       /// MCP ///
      /// SUP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

supabase-mcp-server

by alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface (SQL execution, Management API, Auth Admin SDK, automatic migrations, safety layer, etc.).

774
93
Open Source
GitHubDocumentation

Installation

1. Clone the repo
git clone https://github.com/alexander-zuev/supabase-mcp-server.git && cd supabase-mcp-server
2. Create and activate a Python virtual-environment (Python ≥3.9)
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
3. Install the package and its dependencies
pip install -r requirements.txt # or, if the project is published on PyPI pip install supabase-mcp-server
4. 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 endpoints
5. Run database migrations (optional, enables version tracking)
python -m supabase_mcp_server migrate
6. 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 8000
7. Verify
curl -H "Authorization: Bearer $MCP_AUTH_TOKEN" http://localhost:8000/healthz

Documentation

License: Apache License 2.0
Updated 7/30/2025

Table of Contents