Skip to content
AgentAtlas

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
Full steps for Claude Code →

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

get_server_configuration_statustest_cluster_connectionget_cluster_health_and_servicesget_buckets_in_clusterget_scopes_and_collections_in_bucketget_schema_for_collectionget_document_by_idupsert_document_by_iddelete_document_by_idlist_indexesget_index_advisor_recommendationscreate_query_indexrun_sql_plus_plus_queryexplain_sql_plus_plus_queryrun_searchrun_vector_queryrun_vector_searchget_longest_running_queriesget_active_queries

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 →