How to Connect Supabase Remote MCP to Gemini CLI

Add Supabase's remote MCP server to Gemini CLI in about a minute.

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1ยทhttps://mcp.supabase.com/mcp

Step-by-step

  1. Edit ~/.gemini/settings.json
    Add the mcpServers entry shown above โ€” Gemini CLI uses httpUrl for Streamable HTTP endpoints and url for legacy SSE.
  2. Authorize
    On first use your client opens a Supabase OAuth consent screen โ€” approve it and tools become available.
  3. Verify
    Restart gemini, then run /mcp list inside the CLI. Verify in the browser: paste https://mcp.supabase.com/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

  • A 401 Unauthorized on first connect is normal โ€” the endpoint is OAuth-protected; let Gemini CLI finish the browser consent flow.
  • If the consent window never opens, remove and re-add the server, then retry.
  • Check the exact challenge at our OAuth debugger.
  • Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Streamable HTTPhttps://mcp.supabase.com/mcp

Add to ~/.gemini/settings.json under mcpServers โ€” httpUrl for Streamable HTTP, url for legacy SSE:

{
  "mcpServers": {
    "supabase": {
      "httpUrl": "https://mcp.supabase.com/mcp"
    }
  }
}

Tools exposed by Supabase MCP (30)

ToolSafetyDescriptionParameters
list_organizations
~31 tok
๐ŸŸข ReadList Supabase organizations.โ€”
get_organization
~33 tok
๐ŸŸข ReadGet details of a Supabase organization.โ€”
list_projects
~28 tok
๐ŸŸข ReadList Supabase projects.โ€”
get_project
~31 tok
๐ŸŸข ReadGet details of a Supabase project.โ€”
get_project_url
~33 tok
๐ŸŸข ReadGet the API URL of a Supabase project.โ€”
get_publishable_keys
~35 tok
๐ŸŸข ReadGet publishable/anon API keys for a project.โ€”
get_cost
~33 tok
๐ŸŸข ReadEstimate the cost of a new project or branch.โ€”
confirm_cost
~35 tok
๐ŸŸข ReadConfirm a cost estimate before resource creation.โ€”
create_project
~30 tok
๐ŸŸ  WriteCreate a new Supabase project.โ€”
pause_project
~29 tok
๐ŸŸ  WritePause a Supabase project.โ€”
restore_project
~32 tok
๐ŸŸ  WriteRestore a paused Supabase project.โ€”
list_tables
~31 tok
๐ŸŸข ReadList tables in a project database.โ€”
list_extensions
~32 tok
๐ŸŸข ReadList installed Postgres extensions.โ€”
list_migrations
~31 tok
๐ŸŸข ReadList applied database migrations.โ€”
apply_migration
~35 tok
๐ŸŸ  WriteApply a SQL migration to the project database.โ€”
execute_sql
~35 tok
๐Ÿ”ด DestructiveExecute arbitrary SQL against the project database.โ€”
get_logs
~32 tok
๐ŸŸข ReadRetrieve recent logs for a Supabase service.โ€”
get_advisors
~34 tok
๐ŸŸข ReadGet security and performance advisor findings.โ€”
generate_typescript_types
~38 tok
๐ŸŸข ReadGenerate TypeScript types from the database schema.โ€”
search_docs
~31 tok
๐ŸŸข ReadSearch the Supabase documentation.โ€”
create_branch
~33 tok
๐ŸŸ  WriteCreate a development branch of a project.โ€”
list_branches
~32 tok
๐ŸŸข ReadList development branches of a project.โ€”
delete_branch
~30 tok
๐Ÿ”ด DestructiveDelete a development branch.โ€”
merge_branch
~33 tok
๐Ÿ”ด DestructiveMerge a development branch into production.โ€”
reset_branch
~33 tok
๐Ÿ”ด DestructiveReset a development branch to a prior state.โ€”
rebase_branch
~34 tok
๐ŸŸ  WriteRebase a development branch onto production.โ€”
deploy_edge_function
~34 tok
๐ŸŸ  WriteDeploy an edge function to a project.โ€”
list_edge_functions
~31 tok
๐ŸŸข ReadList deployed edge functions.โ€”
get_edge_function
~32 tok
๐ŸŸข ReadGet details of an edge function.โ€”
create_storage_bucket
~31 tok
๐ŸŸ  WriteCreate a storage bucket.โ€”

Connect Supabase MCP to another client

Other servers for Gemini CLI

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline261ms
Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~606 tok18 toolsOnline21ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~899 tok30 toolsOnline8ms

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿงฉ MCP App๐Ÿ›ก๏ธ A+~286 tok8 toolsOnline231ms
AWS KnowledgeAmazon Web Services

AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ€” connect and call tools immediately.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline155ms

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~1336 tok43 toolsOnline217ms