home / mcp / supabase mcp server

Supabase MCP Server

Provides programmatic access to Supabase Management API for managing projects and organizations.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "joshuarileydev-supabase-mcp-server": {
      "command": "npx",
      "args": [
        "y",
        "@joshuarileydev/supabase-mcp-server"
      ],
      "env": {
        "SUPABASE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

This MCP server provides programmatic access to the Supabase Management API, letting you manage projects and organizations through a standardized interface. It enables AI models and clients to list, view, create, and delete resources, streamlining automation and integration tasks.

How to use

You connect to the Supabase MCP Server from your MCP client by configuring the MCP server you want to run, then invoking the standard actions exposed by the server. With this server, you can list all projects and organizations, view detailed information about a project or organization, create new projects or organizations, delete projects, and retrieve project API keys. To perform these actions, ensure your MCP client is set up to target the Supabase MCP server and that you provide your API key when required by the server.

How to install

Prerequisites you need before installing the MCP server:

Node.js and npm should be installed on your system
Access to your environment to store the API key for authentication

Step-by-step setup using the provided MCP server configuration:

# Ensure Node.js and npm are installed
node -v
npm -v

# Create or update your MCP client config with the Supabase MCP Server
# The configuration snippet below runs the MCP server locally via npx

How to run the Supabase MCP Server

Set your Supabase API key in your environment and start the MCP server using the provided command and arguments. The server runs locally and listens for MCP client requests.

# Start the Supabase MCP Server using npx
# Command and arguments are provided in the configuration snippet
npx y @joshuarileydev/supabase-mcp-server

Notes on configuration and access

The server configuration requires an API key for Supabase access. You supply this as an environment variable named SUPABASE_API_KEY. Store this key securely and avoid exposing it in client configurations or logs.

Available tools

listProjects

List all projects under your Supabase account.

getProjectDetails

Retrieve details for a specific project by its identifier.

createProject

Create a new project with the required parameters.

deleteProject

Delete a project by its identifier.

getProjectApiKeys

Retrieve the API keys for a specific project.

listOrganizations

List all organizations you manage.

getOrganizationDetails

Retrieve details for a specific organization by its identifier.

createOrganization

Create a new organization with the necessary information.