mcp-registry/supabase-mcp

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

supabase-mcp

by supabase-community

Node-based Model Context Protocol server that exposes Supabase projects (tables, docs, functions, etc.) to AI assistants such as Augment Code, Claude and other AI coding agents.

1.8k
167
Open Source
GitHubWebsiteDiscord

Installation

1. Prerequisites
• Node.js ≥ 18
• A Supabase project (obtain your SUPABASE_URL, SUPABASE_ANON_KEY and a SERVICE_ROLE_KEY)
2. Install the package
# with npm npm install supabase-mcp --save # or with pnpm pnpm add supabase-mcp # or with yarn yarn add supabase-mcp
3. Create an environment file `.env` in your project root:
SUPABASE_URL=https://<your-project>.supabase.co SUPABASE_ANON_KEY=ey... (public anon key) SUPABASE_SERVICE_ROLE_KEY=ey... (service role key) OPENAI_API_KEY=sk-... MCP_PORT=3000 # optional, defaults to 3000
4. Start the MCP server
npx supabase-mcp start # or if installed globally supabase-mcp start
The server will listen on http://localhost:3000 by default.
5. Deploy
• Local: keep the process running with PM2, Docker or a systemd unit
• Supabase Edge Functions / Vercel / Fly.io: build as a normal TypeScript project (`npm run build`) and deploy the output folder.
6. Verify
Open http://localhost:3000/health to make sure the service returns `{ status: "ok" }`.
Optional configuration
• `MCP_JWT_SECRET` – override the default signing secret.
• `LOG_LEVEL` – set to `debug` for verbose logging.

Documentation

License: Apache License 2.0
Updated 7/15/2025