Supabase MCP Server logo

Supabase MCP Server

by Cappahccino

The Supabase MCP Server allows Claude and other LLMs to interact with Supabase to perform CRUD operations on Postgres tables. It provides a Model Context Protocol (MCP) interface for database interaction.

View on GitHub

Last updated: N/A

What is Supabase MCP Server?

The Supabase MCP Server is a bridge that enables Large Language Models (LLMs) like Claude to interact with a Supabase Postgres database. It implements the Model Context Protocol (MCP) to facilitate CRUD operations (Create, Read, Update, Delete) on database tables.

How to use Supabase MCP Server?

The server can be installed via npm or by cloning the repository. Configuration involves setting up a .env file with Supabase credentials and an API key. It can be used with Claude by configuring the Claude Desktop MCP settings, or as a standalone server via command line. It can also be used as a library in Node.js projects.

Key features of Supabase MCP Server

  • Query data with filters

  • Insert data

  • Update data

  • Delete data

  • List tables

Use cases of Supabase MCP Server

  • Allowing LLMs to retrieve information from a Supabase database

  • Enabling LLMs to modify data in a Supabase database

  • Building applications where LLMs can interact with structured data

  • Integrating LLMs with existing Supabase projects

FAQ from Supabase MCP Server

Port XXXX is already in use

Specify a different port in your .env file by changing the MCP_SERVER_PORT value.

Missing required environment variables

Ensure you have a proper .env file with all the required values or that you've set the environment variables in your system.

TypeError: Class constructor Server cannot be invoked without 'new'

Update to the latest version of the package using npm install -g supabase-mcp@latest.

JSON parsing errors with Claude

Use the Claude-specific binary (supabase-mcp-claude) instead of the regular HTTP server (supabase-mcp).

Request timed out with Claude

Check your Supabase credentials, server setup, and network connectivity.