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

# Transform Augment Code into Your Full-Stack Supabase Development Partner

The Supabase MCP server turns Augment Code into a comprehensive development assistant that can interact directly with your Supabase projects. Instead of just generating code, Augment can now query your database, deploy functions, manage schemas, and debug issues—all within your natural coding workflow.

## Seamless Database-Driven Development

With this MCP server, Augment Code gains direct access to your Supabase database through 25+ specialized tools. Ask Augment to "show me all users created in the last week" and it will execute the SQL query directly. Need to modify a table schema? Augment can apply migrations, generate TypeScript types, and update your codebase accordingly—all in one conversation. The server includes built-in safety features like read-only mode and project scoping to keep your data secure while maximizing productivity.

## Complete Full-Stack Workflow Integration

This integration transforms how you build with Supabase. Augment can now deploy Edge Functions you're working on, search Supabase docs for the latest features, access project logs for debugging, and even manage development branches. When you're stuck on a Supabase integration, Augment can pull real-time documentation, check your current schema, and generate the exact code you need. The server's feature groups let you customize which capabilities Augment has access to, from basic database queries to advanced branching workflows.

## Setup for Maximum Impact

Configure this MCP server in your Augment Code settings to unlock the full development experience:

```json
{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--read-only",
        "--project-ref=your-project-ref"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "your-personal-access-token"
      }
    }
  }
}
```

Now when you're coding, Augment can instantly query your database structure, deploy functions, generate TypeScript types, and help debug issues by accessing real project logs—making it your complete Supabase development companion.
License: Apache License 2.0
Updated 7/15/2025

Table of Contents