Supabase MCP Server

@Cappahccino

Basic information

About Supabase MCP Server

Supabase Model Context Protocol (MCP) server for CRUD operations and Edge Functions

Supabase MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "supabase-mcp@latest",
        "supabase-mcp-claude"
      ],
      "env": {
        "SUPABASE_URL": "",
        "SUPABASE_ANON_KEY": "",
        "SUPABASE_SERVICE_ROLE_KEY": "",
        "MCP_API_KEY": ""
      }
    }
  }
}

Supabase MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Supabase MCP Server?

It is a Model Context Protocol (MCP) server that lets Claude and other large language models perform CRUD operations—query, insert, update, delete, and list tables—on Postgres tables in a Supabase project.

How to use Supabase MCP Server?

Install globally or locally via npm, then configure Supabase credentials and an API key. For Claude Desktop, use the dedicated supabase-mcp-claude binary with stdio transport. For standalone use, run the HTTP server at a configurable port. It can also be imported as a library in Node.js projects.

Key features of Supabase MCP Server

Query data with filters
Insert data into tables
Update existing records
Delete records by conditions
List all tables in the database
Supports both stdio (Claude) and HTTP transports

Use cases of Supabase MCP Server

Give Claude direct read/write access to a Supabase database via natural language
Automate database tasks such as bulk inserts or conditional updates
Enable AI-driven data exploration and reporting on Supabase projects

Frequently asked questions

What are the prerequisites?

Node.js v16 or newer, npm or yarn, and a Supabase project with your API keys (URL, anon key, and service role key).

How do I fix "Port XXXX is already in use"?

The server automatically tries to find an available port. You can manually set a different port in your `.env` file by changing `MCP_SERVER_PORT`.

Why do I get "Missing required environment variables"?

Ensure you have a valid `.env` file with `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `SUPABASE_SERVICE_ROLE_KEY`, and `MCP_API_KEY`, or set those variables in your system environment.

What transport should I use for Claude?

Use the Claude-specific binary (`supabase-mcp-claude`) with the stdio transport. The regular HTTP server (`supabase-mcp`) is for standalone use and is not compatible with Claude Desktop.

How do I resolve "Request timed out with Claude"?

Check that your Supabase credentials are correct, the server is running, and no network issues are blocking the connection. Also ensure you are using the Claude binary, not the HTTP server.

Comments

More Cloud & Infrastructure MCP servers

container-use

dagger

Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.

3.9K

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828

OutageDeck

outagedeck

Official OutageDeck MCP server for vendor-published cloud and SaaS status, incident timelines, and observed uptime history.

Lium - GPU cloud

Lium

Find, price and rent GPUs on Lium from Claude, ChatGPT, Codex or any MCP client. Search live GPU availability and prices (H100, H200, B200, RTX 4090 and more), estimate provider earnings, and with Sign in with Lium or a

container-use

aluzzardi

Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.

3.9K