Practical overview
When it fits
Use it when an MCP-compatible client should perform documented database or project operations against Supabase. Installation requires Python 3.12 or later; connection configuration requires project credentials and a QUERY_API_KEY.
Who it is for
- Developers using an MCP-compatible IDE or chat interface to work with Supabase projects.
- Teams that want database queries and selected Supabase management operations available through an MCP connection.
Documented uses
- Run read-only or read-write SQL queries against a Supabase database.
- Track schema changes through automatic migration versioning.
- Call Supabase Management API operations and Auth Admin methods.
- Retrieve Supabase logs through a chat or IDE workflow.
Requirements & limits
The README requires Python 3.12 or later, Supabase project configuration, and a QUERY_API_KEY for all operations. It describes the project as no longer actively maintained.
- The README lists Cursor, Windsurf, Cline and other MCP clients supporting stdio as compatible clients.
- SQL execution supports read-only and read-write modes and distinguishes safe, write and destructive operations.
- Remote Supabase projects require the correct region setting; local Supabase development may require a PostgreSQL installation.
- The repository author says active maintenance has stopped following the release of Supabase’s official MCP server.
- Apache-2.0 license; Python implementation.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the MCP server package
Install the server locally using pipx or uv, as described in the project README.
Before you start
- Python 3.12 or later
- pipx or uv
Steps
Choose pipx or uv as the Python package manager.
Install the package with
pipx install supabase-mcp-serveror the command below.uv pip install supabase-mcp-serverContinue to the repository’s configuration instructions to connect a Supabase project.
Expected outcome
The supabase-mcp-server package is installed; project connection requires the separate configuration stage.
Guide limitations
- Installation alone does not configure a Supabase connection.
- The server requires a QUERY_API_KEY for all operations.
- The repository says it is no longer actively maintained.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 6 November 2026
- Original website title
- alexander-zuev/supabase-mcp-server · Official homepage title · retained in its source language
Related options
Supabase official MCP server — The repository author points readers to Supabase’s official MCP server and says it is no less feature-rich; the author has stopped actively maintaining this project.

