Query | MCP server for Supabase

Source

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

Catalog onlyCatalog onlySTDIO

Overview

Supabase MCP Server is a Model Context Protocol (MCP) server that provides programmatic access to the Supabase Management API, allowing AI models and clients to manage Supabase projects and organizations through a standardized interface.

To use Supabase MCP Server, integrate it by adding the required configuration to your Claude Config JSON file, specifying your Supabase API key and the command for npx to run the server.

Project Management: List, create, delete projects, and retrieve project API keys. - Organization Management: List and create organizations, and fetch organization details.

Automating the management of Supabase projects programmatically.
Integrating AI systems with Supabase for effortless project and organization handling.
Simplifying API interactions for developers using Supabase services.

Add to your AI client

Use these steps to connect Query | MCP server for Supabase in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "supabase-mcp-server-alexander-zuev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "supabase-mcp-server-alexander-zuev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "supabase-mcp-server-alexander-zuev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "supabase-mcp-server-alexander-zuev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "supabase-mcp-server-alexander-zuev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "supabase-mcp-server-alexander-zuev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-mcp-server-alexander-zuev"
      ]
    }
  }
}

FAQ

What is the main function of Supabase MCP Server?

It provides a standardized interface for managing Supabase projects and organizations through programmatic access.

Is Supabase MCP Server free to use?

Yes! The server can be used freely along with the Supabase platform, subject to Supabase's pricing plans for usage.

What prerequisites are needed to use Supabase MCP Server?

You need to have a Supabase account and an API key to configure and run the server.

Developer tools