Skip to content
AgentAtlas

Couchbase · Gemini CLI

Add the Couchbase MCP server to Gemini CLI

Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters.

Official serverLocalDatabases

1. Add the server

Run in your terminal

gemini mcp add couchbase uvx couchbase-mcp-server operational

Scopes, env vars, OAuth and limits: Gemini CLI MCP config guide

2. Sign in

Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server. Couchbase runs locally; set any credentials Couchbase asks for before starting Gemini CLI.

3. Try it

Ask Gemini CLI for something Couchbase can do. Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters. Approve the first tool call and check the result before allowing write actions automatically.

  • · In settings.json, streamable HTTP servers use httpUrl, SSE servers use url, local servers use command.
  • · includeTools and excludeTools limit which tools the model sees.

FAQ

How do I add the Couchbase MCP server to Gemini CLI?
Run: gemini mcp add couchbase uvx couchbase-mcp-server operational. Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server.
Is this the official Couchbase MCP server?
Yes. It is published by Couchbase as io.github.couchbase/mcp-server-couchbase in the official MCP registry.
Does the Couchbase MCP server need an API key?
It runs locally from a package. See Couchbase's docs for any credentials it needs.

Links

Couchbase in other clients

More databases for Gemini CLI

Built an MCP server? Get it listed everywhere →

Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →

Reviewed Oct 21, 2026. Command generated from the registry record and checked against Gemini CLI's documented syntax.