Supabase Integration
An MCP server that provides tools for interacting with Supabase databases, storage, and edge functions.
What is Supabase Integration?
Supabase Integration is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that provides tools for interacting with supabase databases, storage, and edge functions.
An MCP server that provides tools for interacting with Supabase databases, storage, and edge functions.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- list_projects
- get_project
- create_project
- delete_project
- list_organizations
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @joshuarileydev/supabase-mcp-serverManual Installation
npx -y @joshuarileydev/supabase-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Supabase Integration
The Supabase MCP server connects AI assistants like Claude directly to your Supabase projects, enabling natural-language management of databases, storage, edge functions, and organizations through the Supabase Management API. It exposes tools for listing, creating, retrieving, and deleting Supabase projects and organizations without leaving your conversation. Developers and teams use it to inspect project configurations, spin up new Supabase projects, and retrieve API keys programmatically through an AI agent workflow.
Prerequisites
- Node.js 18+ and npm/npx installed
- A Supabase account with at least one organization
- A Supabase Management API key (found in your Supabase account settings)
- Claude Desktop or another MCP-compatible client
Obtain your Supabase Management API key
Log in to app.supabase.com, navigate to your account settings, and generate a Management API key. This is distinct from a project-level anon/service key.
Test the server runs correctly
Run the MCP server once with npx to confirm it starts without errors before wiring it into your client.
npx -y @joshuarileydev/supabase-mcp-serverAdd the server to Claude Desktop configuration
Edit your claude_desktop_config.json to register the Supabase MCP server with your API key as an environment variable.
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": ["-y", "@joshuarileydev/supabase-mcp-server"],
"env": {
"SUPABASE_API_KEY": "your-management-api-key-here"
}
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop so it picks up the new MCP server configuration. The Supabase tools will be available in the next conversation.
Verify tools are available
Ask Claude to list your Supabase projects to confirm the connection is working end-to-end.
Supabase Integration Examples
Client configuration
Claude Desktop config for the Supabase MCP server with the required API key
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": ["-y", "@joshuarileydev/supabase-mcp-server"],
"env": {
"SUPABASE_API_KEY": "sbp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Prompts to try
Use these prompts once the Supabase server is connected to manage your projects through Claude
- "List all my Supabase projects"
- "Get the API keys for my project named 'my-app'"
- "Create a new Supabase project called 'staging' in my organization"
- "List all organizations in my Supabase account"Troubleshooting Supabase Integration
Authentication error when listing projects
Verify SUPABASE_API_KEY is set to a Management API key, not a project-level anon or service role key. Generate a new Management API key from your Supabase account settings page.
Server not found or tools not appearing in Claude
Ensure npx can resolve the package by running `npx -y @joshuarileydev/supabase-mcp-server` in your terminal. If it fails, check your Node.js version (18+ required) and network access.
Project creation fails with a permissions error
Management API keys may have scoped permissions. Ensure the key was generated with write access enabled, and that you have an active Supabase plan that allows programmatic project creation.
Frequently Asked Questions about Supabase Integration
What is Supabase Integration?
Supabase Integration is a Model Context Protocol (MCP) server that mcp server that provides tools for interacting with supabase databases, storage, and edge functions. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Supabase Integration?
Install via npm with the command: npx -y @joshuarileydev/supabase-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Supabase Integration?
Supabase Integration works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Supabase Integration free to use?
Yes, Supabase Integration is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Supabase Integration Alternatives — Similar Databases Servers
Looking for alternatives to Supabase Integration? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Supabase Integration in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Supabase Integration?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.