SERVER

MCP Server Couchbase

Rank #1,272

io.github.couchbase/mcp-server-couchbase

Couchbase MCP Server - Enable AI agents to connect to and interact with Couchbase clusters.

21 versions

36 GitHub stars

by couchbase (1 servers)View repository ↗Claim this server

First listed

Mar 26, 2025

Last publish date

Sep 15, 2026

OVERVIEW

MCP Server Couchbase is a Model Context Protocol (MCP) server published by couchbase. It ranks #1,272 of 132,046 servers tracked on MCP Toplist, and its repository has 36 GitHub stars. MCP Server Couchbase is listed across 3 registries — Official MCP, mcp.so and Glama, with 21 tracked versions. It was first listed on Mar 26, 2025 and most recently updated on Sep 15, 2026.

STANDING

#1,272of 132,046 tracked serversTop 1%

Ranks ahead of 130,774 of 132,046 servers on MCP Toplist.

CONNECT

Use MCP Server Couchbase

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

Python package (PyPI)

claude mcp add mcp-server-couchbase -e "CB_CONNECTION_STRING=<your CB_CONNECTION_STRING>" -e "CB_USERNAME=<your CB_USERNAME>" -e "CB_PASSWORD=<your CB_PASSWORD>" -e "CB_CA_CERT_PATH=<your CB_CA_CERT_PATH>" -e "CB_CLIENT_CERT_PATH=<your CB_CLIENT_CERT_PATH>" -e "CB_CLIENT_KEY_PATH=<your CB_CLIENT_KEY_PATH>" -e "CB_MCP_READ_ONLY_MODE=<your CB_MCP_READ_ONLY_MODE>" -e "CB_MCP_TRANSPORT=<your CB_MCP_TRANSPORT>" -e "CB_MCP_HOST=<your CB_MCP_HOST>" -e "CB_MCP_PORT=<your CB_MCP_PORT>" -e "CB_MCP_DISABLED_TOOLS=<your CB_MCP_DISABLED_TOOLS>" -e "CB_MCP_CONFIRMATION_REQUIRED_TOOLS=<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>" -e "CB_MCP_LOG_LEVEL=<your CB_MCP_LOG_LEVEL>" -e "CB_MCP_LOG_SINKS=<your CB_MCP_LOG_SINKS>" -e "CB_MCP_LOG_FILE=<your CB_MCP_LOG_FILE>" -e "CB_MCP_LOG_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_MAX_BYTES=<your CB_MCP_LOG_MAX_BYTES>" -e "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>" -e "CB_MCP_OAUTH_JWT_JWKS_URI=<your CB_MCP_OAUTH_JWT_JWKS_URI>" -e "CB_MCP_OAUTH_JWT_ISSUER=<your CB_MCP_OAUTH_JWT_ISSUER>" -e "CB_MCP_OAUTH_JWT_AUDIENCE=<your CB_MCP_OAUTH_JWT_AUDIENCE>" -e "CB_MCP_OAUTH_JWT_ALGORITHM=<your CB_MCP_OAUTH_JWT_ALGORITHM>" -e "CB_MCP_OAUTH_MCP_BASE_URL=<your CB_MCP_OAUTH_MCP_BASE_URL>" -e "CB_MCP_OAUTH_SCOPE_READ_LABEL=<your CB_MCP_OAUTH_SCOPE_READ_LABEL>" -e "CB_MCP_OAUTH_SCOPE_WRITE_LABEL=<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>" -- uvx couchbase-mcp-server

Replace each placeholder with your own value before saving.

Docker image

claude mcp add mcp-server-couchbase -e "CB_CONNECTION_STRING=<your CB_CONNECTION_STRING>" -e "CB_USERNAME=<your CB_USERNAME>" -e "CB_PASSWORD=<your CB_PASSWORD>" -e "CB_CA_CERT_PATH=<your CB_CA_CERT_PATH>" -e "CB_CLIENT_CERT_PATH=<your CB_CLIENT_CERT_PATH>" -e "CB_CLIENT_KEY_PATH=<your CB_CLIENT_KEY_PATH>" -e "CB_MCP_READ_ONLY_MODE=<your CB_MCP_READ_ONLY_MODE>" -e "CB_MCP_TRANSPORT=<your CB_MCP_TRANSPORT>" -e "CB_MCP_HOST=<your CB_MCP_HOST>" -e "CB_MCP_PORT=<your CB_MCP_PORT>" -e "CB_MCP_DISABLED_TOOLS=<your CB_MCP_DISABLED_TOOLS>" -e "CB_MCP_CONFIRMATION_REQUIRED_TOOLS=<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>" -e "CB_MCP_LOG_LEVEL=<your CB_MCP_LOG_LEVEL>" -e "CB_MCP_LOG_SINKS=<your CB_MCP_LOG_SINKS>" -e "CB_MCP_LOG_FILE=<your CB_MCP_LOG_FILE>" -e "CB_MCP_LOG_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_MAX_BYTES=<your CB_MCP_LOG_MAX_BYTES>" -e "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB=<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>" -e "CB_MCP_LOG_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>" -e "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT=<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>" -e "CB_MCP_OAUTH_JWT_JWKS_URI=<your CB_MCP_OAUTH_JWT_JWKS_URI>" -e "CB_MCP_OAUTH_JWT_ISSUER=<your CB_MCP_OAUTH_JWT_ISSUER>" -e "CB_MCP_OAUTH_JWT_AUDIENCE=<your CB_MCP_OAUTH_JWT_AUDIENCE>" -e "CB_MCP_OAUTH_JWT_ALGORITHM=<your CB_MCP_OAUTH_JWT_ALGORITHM>" -e "CB_MCP_OAUTH_MCP_BASE_URL=<your CB_MCP_OAUTH_MCP_BASE_URL>" -e "CB_MCP_OAUTH_SCOPE_READ_LABEL=<your CB_MCP_OAUTH_SCOPE_READ_LABEL>" -e "CB_MCP_OAUTH_SCOPE_WRITE_LABEL=<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>" -- docker run -i --rm docker.io/couchbase/mcp-server:1.0.2rc4

Replace each placeholder with your own value before saving.

Python package (PyPI)

[mcp_servers.mcp-server-couchbase]
command = "uvx"
args = ["couchbase-mcp-server"]

[mcp_servers.mcp-server-couchbase.env]
CB_CONNECTION_STRING = "<your CB_CONNECTION_STRING>"
CB_USERNAME = "<your CB_USERNAME>"
CB_PASSWORD = "<your CB_PASSWORD>"
CB_CA_CERT_PATH = "<your CB_CA_CERT_PATH>"
CB_CLIENT_CERT_PATH = "<your CB_CLIENT_CERT_PATH>"
CB_CLIENT_KEY_PATH = "<your CB_CLIENT_KEY_PATH>"
CB_MCP_READ_ONLY_MODE = "<your CB_MCP_READ_ONLY_MODE>"
CB_MCP_TRANSPORT = "<your CB_MCP_TRANSPORT>"
CB_MCP_HOST = "<your CB_MCP_HOST>"
CB_MCP_PORT = "<your CB_MCP_PORT>"
CB_MCP_DISABLED_TOOLS = "<your CB_MCP_DISABLED_TOOLS>"
CB_MCP_CONFIRMATION_REQUIRED_TOOLS = "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>"
CB_MCP_LOG_LEVEL = "<your CB_MCP_LOG_LEVEL>"
CB_MCP_LOG_SINKS = "<your CB_MCP_LOG_SINKS>"
CB_MCP_LOG_FILE = "<your CB_MCP_LOG_FILE>"
CB_MCP_LOG_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_MAX_BYTES = "<your CB_MCP_LOG_MAX_BYTES>"
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>"
CB_MCP_OAUTH_JWT_JWKS_URI = "<your CB_MCP_OAUTH_JWT_JWKS_URI>"
CB_MCP_OAUTH_JWT_ISSUER = "<your CB_MCP_OAUTH_JWT_ISSUER>"
CB_MCP_OAUTH_JWT_AUDIENCE = "<your CB_MCP_OAUTH_JWT_AUDIENCE>"
CB_MCP_OAUTH_JWT_ALGORITHM = "<your CB_MCP_OAUTH_JWT_ALGORITHM>"
CB_MCP_OAUTH_MCP_BASE_URL = "<your CB_MCP_OAUTH_MCP_BASE_URL>"
CB_MCP_OAUTH_SCOPE_READ_LABEL = "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>"
CB_MCP_OAUTH_SCOPE_WRITE_LABEL = "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Docker image

[mcp_servers.mcp-server-couchbase]
command = "docker"
args = ["run", "-i", "--rm", "docker.io/couchbase/mcp-server:1.0.2rc4"]

[mcp_servers.mcp-server-couchbase.env]
CB_CONNECTION_STRING = "<your CB_CONNECTION_STRING>"
CB_USERNAME = "<your CB_USERNAME>"
CB_PASSWORD = "<your CB_PASSWORD>"
CB_CA_CERT_PATH = "<your CB_CA_CERT_PATH>"
CB_CLIENT_CERT_PATH = "<your CB_CLIENT_CERT_PATH>"
CB_CLIENT_KEY_PATH = "<your CB_CLIENT_KEY_PATH>"
CB_MCP_READ_ONLY_MODE = "<your CB_MCP_READ_ONLY_MODE>"
CB_MCP_TRANSPORT = "<your CB_MCP_TRANSPORT>"
CB_MCP_HOST = "<your CB_MCP_HOST>"
CB_MCP_PORT = "<your CB_MCP_PORT>"
CB_MCP_DISABLED_TOOLS = "<your CB_MCP_DISABLED_TOOLS>"
CB_MCP_CONFIRMATION_REQUIRED_TOOLS = "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>"
CB_MCP_LOG_LEVEL = "<your CB_MCP_LOG_LEVEL>"
CB_MCP_LOG_SINKS = "<your CB_MCP_LOG_SINKS>"
CB_MCP_LOG_FILE = "<your CB_MCP_LOG_FILE>"
CB_MCP_LOG_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_MAX_BYTES = "<your CB_MCP_LOG_MAX_BYTES>"
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB = "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>"
CB_MCP_LOG_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>"
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT = "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>"
CB_MCP_OAUTH_JWT_JWKS_URI = "<your CB_MCP_OAUTH_JWT_JWKS_URI>"
CB_MCP_OAUTH_JWT_ISSUER = "<your CB_MCP_OAUTH_JWT_ISSUER>"
CB_MCP_OAUTH_JWT_AUDIENCE = "<your CB_MCP_OAUTH_JWT_AUDIENCE>"
CB_MCP_OAUTH_JWT_ALGORITHM = "<your CB_MCP_OAUTH_JWT_ALGORITHM>"
CB_MCP_OAUTH_MCP_BASE_URL = "<your CB_MCP_OAUTH_MCP_BASE_URL>"
CB_MCP_OAUTH_SCOPE_READ_LABEL = "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>"
CB_MCP_OAUTH_SCOPE_WRITE_LABEL = "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/couchbase/mcp-server:1.0.2rc4"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/couchbase/mcp-server:1.0.2rc4"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "servers": {
    "mcp-server-couchbase": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Docker image

{
  "servers": {
    "mcp-server-couchbase": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/couchbase/mcp-server:1.0.2rc4"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/couchbase/mcp-server:1.0.2rc4"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/couchbase/mcp-server:1.0.2rc4"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<your CB_CONNECTION_STRING>",
        "CB_USERNAME": "<your CB_USERNAME>",
        "CB_PASSWORD": "<your CB_PASSWORD>",
        "CB_CA_CERT_PATH": "<your CB_CA_CERT_PATH>",
        "CB_CLIENT_CERT_PATH": "<your CB_CLIENT_CERT_PATH>",
        "CB_CLIENT_KEY_PATH": "<your CB_CLIENT_KEY_PATH>",
        "CB_MCP_READ_ONLY_MODE": "<your CB_MCP_READ_ONLY_MODE>",
        "CB_MCP_TRANSPORT": "<your CB_MCP_TRANSPORT>",
        "CB_MCP_HOST": "<your CB_MCP_HOST>",
        "CB_MCP_PORT": "<your CB_MCP_PORT>",
        "CB_MCP_DISABLED_TOOLS": "<your CB_MCP_DISABLED_TOOLS>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<your CB_MCP_CONFIRMATION_REQUIRED_TOOLS>",
        "CB_MCP_LOG_LEVEL": "<your CB_MCP_LOG_LEVEL>",
        "CB_MCP_LOG_SINKS": "<your CB_MCP_LOG_SINKS>",
        "CB_MCP_LOG_FILE": "<your CB_MCP_LOG_FILE>",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_MAX_BYTES": "<your CB_MCP_LOG_MAX_BYTES>",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "<your CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB>",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT>",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "<your CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT>",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "<your CB_MCP_OAUTH_JWT_JWKS_URI>",
        "CB_MCP_OAUTH_JWT_ISSUER": "<your CB_MCP_OAUTH_JWT_ISSUER>",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "<your CB_MCP_OAUTH_JWT_AUDIENCE>",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "<your CB_MCP_OAUTH_JWT_ALGORITHM>",
        "CB_MCP_OAUTH_MCP_BASE_URL": "<your CB_MCP_OAUTH_MCP_BASE_URL>",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "<your CB_MCP_OAUTH_SCOPE_READ_LABEL>",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "<your CB_MCP_OAUTH_SCOPE_WRITE_LABEL>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.couchbase%2Fmcp-server-couchbase.svg)](https://mcptoplist.com/server/io.github.couchbase%2Fmcp-server-couchbase)

HTML

<a href="https://mcptoplist.com/server/io.github.couchbase%2Fmcp-server-couchbase"><img src="https://mcptoplist.com/badge/io.github.couchbase%2Fmcp-server-couchbase.svg" alt="MCP Toplist: Top 1% of 132,046" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 4 registries (1 delisted)

Official MCP

mcp.so

GlamaDelisted · last seen Jun 24, 2026

Official MCP

Glama

ORGANIZATION

couchbase

Organization

couchbase

Servers in org

Versions across org

VERSIONS

Available versions (21)

Version	Published
1.0.2rc4	Sep 15, 2026
1.0.2rc3	Sep 11, 2026
1.0.2rc2	Sep 10, 2026
1.0.2rc1	Sep 10, 2026
1.0.1.post1	Aug 25, 2026
1.0.1	Aug 13, 2026
1.0.1rc1	Aug 10, 2026
1.0.0.post1	Jun 30, 2026
1.0.0	Jun 26, 2026
0.8.0.post1	Jun 18, 2026
0.8.1rc2	Jun 9, 2026
0.8.0	May 27, 2026
0.7.1	Apr 9, 2026
0.7.0	Apr 1, 2026
0.6.1	Feb 6, 2026
0.5.3	Dec 10, 2025
0.5.2	Nov 13, 2025
0.5.2rc6	Nov 12, 2025
0.5.2rc5	Nov 12, 2025
0.5.2rc4	Nov 12, 2025
0.1.0	Nov 25, 2024

FAQ

Frequently asked questions

Who maintains MCP Server Couchbase?: MCP Server Couchbase is maintained by couchbase, which publishes 1 MCP server (21 total versions) tracked on MCP Toplist.
Is MCP Server Couchbase listed on the Official MCP Registry?: Yes — MCP Server Couchbase is listed on the Official MCP Registry, alongside mcp.so and Glama.
How many versions does MCP Server Couchbase have?: MCP Toplist tracks 21 versions of MCP Server Couchbase, most recently published on Sep 15, 2026.
Where can I find the source code for MCP Server Couchbase?: The source code for MCP Server Couchbase is hosted at github.com/couchbase/mcp-server-couchbase.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers