Skip to content

Claude Desktop Supabase execute_sql

How to: Claude Desktop Supabase execute_sql

client:Claude Desktop transport:stdio tool:execute_sql

Add Supabase to Claude Desktop

  1. 01

    Open ~/Library/Application Support/Claude/claude_desktop_config.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "mcp-server-supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
      }
    }
  }
}
  1. 02

    Save the file and restart Claude Desktop.

  2. 03

    Ask for something execute_sql does. Claude Desktop lists the server's tools on connect and calls execute_sql itself — you do not invoke it by name.

  3. 04

    If nothing happens, check the server is running and that Supabase's identifier in your config matches the one above exactly.

Settings → Developer → Edit Config opens this file. Restart the app after saving. Claude Desktop docs

Set these first

Supabase will not start until these are set, so execute_sql never becomes available.

  • SUPABASE_ACCESS_TOKEN

Same tool, other clients

Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.