Official server by Couchbase
Couchbase MCP server
Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters.
Install
Pick your agent and copy one line. Remote servers ask you to sign in on first use.
claude mcp add couchbase -- uvx couchbase-mcp-server operational
# ~/.codex/config.toml [mcp_servers.couchbase] command = "uvx" args = ["couchbase-mcp-server", "operational"]
gemini mcp add couchbase uvx couchbase-mcp-server operational
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server",
"operational"
]
}
}
}code --add-mcp '{"name":"couchbase","command":"uvx","args":["couchbase-mcp-server","operational"]}'What it can do
From Couchbase's own MCP documentation.
Sign in
Self-hosted server that connects with CB_CONNECTION_STRING plus CB_USERNAME and CB_PASSWORD (or a client certificate and key for mTLS). Optional OAuth 2.1 (JWT/JWKS) when run over Streamable HTTP for shared deployments.
Tools
Options
- Read-only mode is on by default; set CB_MCP_READ_ONLY_MODE=false to allow writes and data-modifying SQL++
- Disable tools or require user confirmation per tool
- Transports: stdio (default), Streamable HTTP and SSE (CB_MCP_TRANSPORT)
- Works with Couchbase Capella and self-managed clusters; a separate Operational Insights server is included
- Install from PyPI (couchbase-mcp-server) or Docker
Good to know
- Some tools (cluster metrics, index stats, query vitals) work only on self-managed Couchbase Server 7.6+ and are not registered on Capella
- Vector queries need Couchbase Server 8.0+ GSI vector indexes or 7.6+ Search, plus a configured embedding provider
- The product collects usage data by default
- Tool disabling guides the model; the Couchbase user's RBAC is the real security boundary
Details
- Registry name
- io.github.couchbase/mcp-server-couchbase
- Latest version
- 1.1.0 (updated 2026-11-02)
- Packages
couchbase-mcp-server (pypi)
couchbase-mcp-server (pypi)
docker.io/couchbase/mcp-server:1.1.0 (oci)
docker.io/couchbase/mcp-server:1.1.0 (oci)
- Links
- Couchbase docsSource
More in Databases
Reviewed Oct 21, 2026. Official means published under Couchbase's namespace in the MCP registry. It is not a security audit.
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 →