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.
1. Add the server
Run in your terminal
gemini mcp add couchbase uvx couchbase-mcp-server
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.
Get the weekly agent stack update
New official MCP servers, spec changes and harness releases, checked against the source. One email a week, no fluff.
FAQ
- How do I add the Couchbase MCP server to Gemini CLI?
- Run: gemini mcp add couchbase uvx couchbase-mcp-server. 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
Work at Couchbase?
Feature Couchbase across the directory and its category from $49/month.
Reviewed Oct 19, 2026. Command generated from the registry record and checked against Gemini CLI's documented syntax.