MCP.so
Sign In

Supabase MCP Server

@Cappahccino

About Supabase MCP Server

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

Basic information

Category

Cloud & Infrastructure

License

MIT license

Runtime

node

Transports

stdio

Publisher

Cappahccino

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": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from Supabase MCP Server

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