by cappahccino
Easily connect Claude and LLMs to Supabase databases and Supabase Edge Functions for secure, code-free CRUD and custom o
Executes SQL queries against Supabase databases through the WayStation integration platform. Provides database access without direct credentials.
Supabase is a community-built MCP server published by cappahccino that provides AI assistants with tools and capabilities via the Model Context Protocol. Easily connect Claude and LLMs to Supabase databases and Supabase Edge Functions for secure, code-free CRUD and custom o It is categorized under databases.
You can install Supabase in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
Supabase is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Enable Claude to query your database directly using natural language
Example
Ask 'Show me top 10 customers by revenue this month' and get SQL results instantly
Eliminate manual SQL writing for ad-hoc queries, get insights 10x faster
Generate complex reports and analytics without leaving conversation
Example
Analyze sales trends, cohort retention, user behavior patterns conversationally
Democratize data access—non-technical team members can query databases
Understand database structure, relationships, and data models
Example
'Explain the user_orders table schema and its relationships'
Onboard engineers faster, explore unfamiliar databases efficiently
Share your MCP server with the developer community
According to our notes, Supabase benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Supabase is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
Useful MCP listing: Supabase is the kind of server we cite when onboarding engineers to host + tool permissions.
Supabase is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Supabase has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Supabase is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
According to our notes, Supabase benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Supabase is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Supabase has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Supabase is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
showing 1-10 of 75
A Model Context Protocol (MCP) server that allows Claude and other LLMs to interact with Supabase to perform CRUD operations on Postgres tables.
The package is published on npm! You can install it globally with:
npm install -g supabase-mcp
Or locally in your project:
npm install supabase-mcp
git clone https://github.com/Cappahccino/SB-MCP.git
cd SB-MCP
npm install
npm run build
Create a .env file with your Supabase credentials:
# Supabase credentials
SUPABASE_URL=your_supabase_project_url
SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
# MCP server configuration
MCP_SERVER_PORT=3000
MCP_SERVER_HOST=localhost
MCP_API_KEY=your_secret_api_key
Claude requires a specific transport mode for compatibility. This package provides a dedicated binary for Claude integration:
"supabase": {
"command": "npx",
"args": [
"-y",
"supabase-mcp@latest",
"supabase-mcp-claude"
],
"env": {
"SUPABASE_URL": "your_supabase_project_url",
"SUPABASE_ANON_KEY": "your_supabase_anon_key",
"SUPABASE_SERVICE_ROLE_KEY": "your_service_role_key",
"MCP_API_KEY": "your_secret_api_key"
}
}
Make sure you set the required environment variables in the configuration. Claude will use the stdio transport for communication.
For testing outside of Claude, you can run:
npm run start:claude
Or if installed globally:
supabase-mcp-claude
After installing globally:
supabase-mcp
This will start the MCP server at http://localhost:3000 (or the port specified in your .env file).
You can also use supabase-mcp as a library in your own Node.js projects:
import { createServer, mcpConfig, validateConfig } from 'supabase-mcp';
// Validate configuration
validateConfig();
// Create the server
const app = createServer();
// Start the server
app.listen(mcpConfig.port, mcpConfig.host, () => {
console.log(`Supabase MCP server running at http://${mcpConfig.host}:${mcpConfig.port}`);
});
The HTTP server attempts to find an available port automatically. You can manually specify a different port in your .env file by changing the MCP_SERVER_PORT value.
Make sure you have a proper .env file with all the required values or that you've set the environment variables in your system.
If you see this error, you may be running an older version of the package. Update to the latest version:
npm install -g supabase-mcp@latest
Make sure you're using the Claude-specific binary (supabase-mcp-claude) instead of the regular HTTP server (supabase-mcp).
This usually means Claude initiated the connection but the server was unable to respond in time. Check:
queryDatabase
table (string): Name of the table to queryselect (string, optional): Comma-separated list of columns (default: "*")query (object, optional): Filter conditionsinsertData
table (string): Name of the tabledata (object or array of objects): Data to insertupdateData
table (string): Name of the tabledata (object): Data to update as key-value pairsquery (object): Filter conditions for the updatedeleteData
table (string): Name of the tablequery (object): Filter conditions for deletionlistTables
MIT
Run data quality queries to catch anomalies and inconsistencies
Example
Find duplicate records, missing values, orphaned foreign keys automatically
Maintain data integrity with less manual SQL work
Prerequisites
Time Estimate
15-30 minutes including configuration and testing
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server acts as bridge between Claude and database, translating natural language to SQL queries and returning results in structured format.
Protocols
Compatibility
✓ Use when
Use for ad-hoc data queries, exploratory analysis, report generation, schema exploration, and democratizing data access. Best for read-heavy analytics workloads.
✗ Avoid when
Avoid for production write operations, mission-critical transactions, real-time OLTP workloads, or when database contains sensitive PII without proper access controls. Use read replicas, not primary.