drio
Open app

Supabase MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

Supabase MCP Server is a tool that enables Cursor and Windsurf IDEs to interact directly with Supabase PostgreSQL databases, providing a seamless database management experience.

To use the Supabase MCP Server, clone the repository, set up your environment, and configure your IDE to connect to the server. You can run it locally or in a production environment.

  • 💻 Compatibility with both Windsurf and Cursor IDEs - ✅ Support for local and production Supabase projects - 🔨 Built-in database exploration tools with schema insights - 🔐 Secure read-only database access - 🔍 SQL query validation
  1. Managing local Supabase databases during development.
  2. Connecting IDEs to production databases for real-time data management.
  3. Validating SQL queries before execution.

Add to your AI client

Use these steps to connect Supabase MCP Server 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": {
    "alexander-zuev-supabase-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-alexander-zuev-supabase-mcp-server-mcp-mirror"
      ]
    }
  }
}

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": {
    "alexander-zuev-supabase-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-alexander-zuev-supabase-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

Can I use Supabase MCP Server with other IDEs?

Currently, it is designed to work specifically with Cursor and Windsurf IDEs.

Is there a cost associated with using Supabase MCP Server?

No, it is open-source and free to use.

What are the prerequisites for using Supabase MCP Server?

You need Python 3.12+, PostgreSQL 16+, and the uv package manager.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1370,"uuid":"2b0e758c-ad98-4d6b-b3b3-df65677ec35f","name":"alexander-zuev_supabase-mcp-server","title":"Supabase MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2025-02-20T15:32:13.094Z","updated_at":"2025-02-23T07:20:28.589Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"supabase,mcp-server,database-management","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/alexander-zuev_supabase-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/user-attachments/assets/d255388e-cb1b-42ea-a7b2-0928f031e0df","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools