Couchbase · Codex
Add the Couchbase MCP server to Codex
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
# ~/.codex/config.toml [mcp_servers.couchbase] command = "uvx" args = ["couchbase-mcp-server"]
Scopes, env vars, OAuth and limits: Codex MCP config guide
2. Sign in
Run codex mcp login <name> to complete OAuth for a remote server. Couchbase runs locally; set any credentials Couchbase asks for before starting Codex.
3. Try it
Ask Codex 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.
- · Each server is a [mcp_servers.<name>] table in config.toml.
- · Use enabled_tools or disabled_tools to keep the tool list short.
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 Codex?
- Run: # ~/.codex/config.toml …. Run codex mcp login <name> to complete OAuth for a remote 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 Codex
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 Codex's documented syntax.