supabase-mcp
Author: supabase-community
Description: 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.
Stars: 1.8k
Forks: 167
License: Apache License 2.0
Category: Open Source
Overview
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-mcp3. 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 30004. 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.
License: Apache License 2.0
Updated 7/15/2025