Supabase's official server for managing tables, querying data and fetching project config, with project scoping and read-only options.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add supabase --env SUPABASE_ACCESS_TOKEN='<SUPABASE_ACCESS_TOKEN>' -- node path/to/your/main.js~/.codex/config.toml
[mcp_servers.supabase]
command = "node"
args = ["path/to/your/main.js"]
env = { SUPABASE_ACCESS_TOKEN = "<SUPABASE_ACCESS_TOKEN>" }
# codex mcp add supabase --env SUPABASE_ACCESS_TOKEN='<SUPABASE_ACCESS_TOKEN>' -- node path/to/your/main.js~/.cursor/mcp.json
{
"mcpServers": {
"supabase": {
"command": "node",
"args": [
"path/to/your/main.js"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"supabase": {
"type": "stdio",
"command": "node",
"args": [
"path/to/your/main.js"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"supabase": {
"command": "node",
"args": [
"path/to/your/main.js"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"supabase": {
"command": "node",
"args": [
"path/to/your/main.js"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"supabase": {
"command": "node",
"args": [
"path/to/your/main.js"
],
"env": {
"SUPABASE_ACCESS_TOKEN": "<SUPABASE_ACCESS_TOKEN>"
}
}
}
}Remote
claude mcp add --transport http supabase https://mcp.supabase.com/mcp~/.codex/config.toml
[mcp_servers.supabase]
url = "https://mcp.supabase.com/mcp"
# codex mcp add supabase --url https://mcp.supabase.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"supabase": {
"httpUrl": "https://mcp.supabase.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.supabase.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}Environment variables
SUPABASE_ACCESS_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.
Try this task
Inspect this project’s database schema. Explain key tables and relationships and identify queries worth checking for indexes. Start with read-only analysis.
- What to provide
- Project scope, database permissions and queries to analyze.
- What to review
- Confirm the environment and read-only permissions. Review proposed changes separately.