MCP.so
Sign In

Supabase MCP Server

@Cappahccino

Basic information

Category

Cloud & Infrastructure

License

MIT license

Transports

stdio

Author

Cappahccino

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

1

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).

2

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`.

3

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.

4

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.

5

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