Repolode
Submit
supabase

supabase/mcp

A hosted Model Context Protocol server that lets AI assistants like Cursor, Claude and Windsurf manage and query your Supabase projects.

View on GitHubWebsite
Stars
2,968
Forks
422
Open issues
133
Last commit
19 hours ago

What is it?

Supabase MCP Server implements the Model Context Protocol so AI assistants can connect directly to a Supabase project. Once connected, an assistant can perform tasks such as managing tables, fetching project configuration and querying data.

The main endpoint is hosted at mcp.supabase.com and is configured in clients by adding an HTTP server URL. Clients prompt for a Supabase login during setup, and you choose the organization that contains the project to work with. Locally, the Supabase CLI exposes a limited subset of tools at localhost, and self-hosted Supabase deployments can enable the same kind of endpoint.

The @supabase/mcp-server-supabase package also exports helpers for the Vercel AI SDK and for serving the tools from your own HTTP endpoint. A separate PostgREST MCP server package lets end users reach your app's REST API through MCP.

Key features

  • 01Connects Cursor, Claude, Windsurf and other MCP-compatible AI assistants to a Supabase project
  • 02Lets assistants manage tables and fetch project configuration
  • 03Supports querying project data through the assistant
  • 04Offers URL parameters to limit feature groups, read-only mode and a single project
  • 05Provides a local CLI endpoint and self-hosted endpoint with a reduced tool set

Use cases

  • Letting an AI coding assistant create or modify tables while building a Supabase app
  • Giving an assistant read-only access to a project's database for analysis
  • Embedding Supabase tools into a custom AI application via the AI SDK

Quick start

  1. 1

    Read the security best practices before connecting an LLM to your Supabase projects

  2. 2

    Add the hosted Supabase MCP server URL to your MCP client configuration

  3. 3

    Log in to Supabase when your MCP client prompts you, and choose the organization containing your project

Things to know

  • The CLI and self-hosted environments offer only a limited subset of tools and no OAuth 2.1.
  • The hosted server requires a Supabase login and access to your Supabase account.

Topics

#mcp#supabase#ai-assistant#postgres#typescript#model-context-protocol

FAQ

What is mcp?
A hosted Model Context Protocol server that lets AI assistants like Cursor, Claude and Windsurf manage and query your Supabase projects. Supabase MCP Server implements the Model Context Protocol so AI assistants can connect directly to a Supabase project. Once connected, an assistant can perform tasks such as managing tables, fetching project configuration and querying data.
Is mcp free to use? What license does it have?
mcp is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is mcp still maintained?
Actively maintained. The last commit to mcp was on Oct 21, 2026.
What can I use mcp for?
Letting an AI coding assistant create or modify tables while building a Supabase app Giving an assistant read-only access to a project's database for analysis Embedding Supabase tools into a custom AI application via the AI SDK
How do I install mcp?
Read the security best practices before connecting an LLM to your Supabase projects Add the hosted Supabase MCP server URL to your MCP client configuration Log in to Supabase when your MCP client prompts you, and choose the organization containing your project
Where can I get mcp?
The source code and installation instructions are on GitHub: https://github.com/supabase/mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects