Supabase MCP Server
@Cappahccino
About Supabase MCP Server
Supabase Model Context Protocol (MCP) server for CRUD operations and Edge Functions
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.
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.
Basic information
More Cloud & Infrastructure MCP servers
container-use
daggerDevelopment environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
Aws Kb Retrieval Server
modelcontextprotocolModel Context Protocol Servers
tfmcp: Terraform Model Context Protocol Tool
nwiizo🌍 Terraform Model Context Protocol (MCP) Tool - An experimental CLI tool that enables AI assistants to manage and operate Terraform environments. Supports reading Terraform configurations, analyzing plans, applying configurations, and managing state with Claude Desktop integrati
Sample Serverless MCP Servers
aws-samplesSample implementations of AI Agents and MCP Servers running on AWS Serverless compute
container-use
aluzzardiDevelopment environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
Comments