Claude Desktop Supabase execute_sql
How to: Claude Desktop Supabase execute_sql
Add Supabase to Claude Desktop
-
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>"
}
}
}
}
-
02
Save the file and restart Claude Desktop.
-
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.
-
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.