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 Cursor, Claude and Windsurf.

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