Supabase MCP Server

Databasestdiov0.3.0
Repository

Official Supabase MCP server for database and backend integration. Enables AI agents to query PostgreSQL databases, manage tables and schemas, handle authentication users, interact with storage buckets, and invoke edge functions. Provides full access to Supabase project management including migrations and type generation.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server"
      ],
      "env": {
        "SUPABASE_URL": "<YOUR_SUPABASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>"
      }
    }
  }
}

Tools (4)

execute_sql

Execute a SQL query against the Supabase PostgreSQL database.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "SQL query to execute"
    },
    "params": {
      "type": "array",
      "description": "Query parameters for parameterized queries"
    }
  }
}

list_tables

List all tables in the database with their schemas and row counts.

{
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "description": "Schema name (default public)"
    }
  }
}

get_table_schema

Get the column definitions and constraints for a specific table.

{
  "type": "object",
  "required": [
    "table"
  ],
  "properties": {
    "table": {
      "type": "string",
      "description": "Table name"
    },
    "schema": {
      "type": "string",
      "description": "Schema name (default public)"
    }
  }
}

manage_storage

Upload, download, or list files in Supabase Storage buckets.

{
  "type": "object",
  "required": [
    "action",
    "bucket"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "File path within the bucket"
    },
    "action": {
      "type": "string",
      "description": "Action to perform (list, upload, download, delete)"
    },
    "bucket": {
      "type": "string",
      "description": "Storage bucket name"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author
Supabase (@supabase)
Repository
https://github.com/supabase-community/supabase-mcp
License
Apache-2.0
Version
0.3.0
Stars
2,706
Last Updated
May 25, 2026
Supabase MCP Server - MCP Server | OpenModels