Couchbase MCP Server

by couchbase-ecosystemio.github.Couchbase-Ecosystem/mcp-server-couchbasev0.8.0

Unified access to Couchbase Capella and self-managed clusters for document operations, SQL++ queries and natural-language data analysis.

35Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Deprecated1d ago

Install Couchbase MCP server

claude mcp add couchbase -e CB_PASSWORD='<cb-password>' -- uvx couchbase-mcp-server

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<cb-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<cb-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "couchbase": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<cb-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<cb-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CB_CONNECTION_STRING	—	—	Couchbase connection string. Required for connecting to the cluster.
CB_USERNAME	—	—	Couchbase database username. Required for basic authentication.
CB_PASSWORD	—	yes	Couchbase database password. Required for basic authentication.
CB_CA_CERT_PATH	—	—	Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.
CB_CLIENT_CERT_PATH	—	—	Couchbase client certificate path. Required for mTLS authentication.
CB_CLIENT_KEY_PATH	—	—	Couchbase client key path. Required for mTLS authentication.
CB_MCP_READ_ONLY_MODE	—	—	Couchbase read only mode. Set to true to disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.
CB_MCP_READ_ONLY_QUERY_MODE	—	—	[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.
CB_MCP_TRANSPORT	—	—	Transport mode for the server (stdio, http or sse). Default is stdio
CB_MCP_HOST	—	—	Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.
CB_MCP_PORT	—	—	Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.
CB_MCP_DISABLED_TOOLS	—	—	Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.
CB_MCP_CONFIRMATION_REQUIRED_TOOLS	—	—	Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.

Freshness

Deprecated — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-08-25 · 46d ago · GitHub · v1.0.1.post1
Package published
no data · npm/PyPI
Registry entry updated
2026-07-02 · 3mo ago · official registry · v0.8.0

FAQ

›How do I install the Couchbase MCP server in Claude Code?

Run: claude mcp add couchbase -e CB_PASSWORD='<cb-password>' -- uvx couchbase-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Couchbase require an API key?

Yes. It expects CB_PASSWORD, of which 1 is a secret.

›Can I use Couchbase as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Couchbase in the official MCP registry?

Yes, as io.github.Couchbase-Ecosystem/mcp-server-couchbase.