Couchbase MCP Server - Enable AI agents to connect to and interact with Couchbase clusters.
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
Get practical integration notes and launch examples for MCP servers like mcp-server-couchbase.
uvx couchbase-mcp-server{
"CB_CONNECTION_STRING": "YOUR_VALUE_HERE",
"CB_USERNAME": "YOUR_VALUE_HERE",
"CB_PASSWORD": "YOUR_SECRET_VALUE",
"CB_CA_CERT_PATH": "YOUR_VALUE_HERE",
"CB_CLIENT_CERT_PATH": "YOUR_VALUE_HERE",
"CB_CLIENT_KEY_PATH": "YOUR_VALUE_HERE",
"CB_MCP_READ_ONLY_MODE": "YOUR_VALUE_HERE",
"CB_MCP_TRANSPORT": "YOUR_VALUE_HERE",
"CB_MCP_HOST": "YOUR_VALUE_HERE",
"CB_MCP_PORT": "YOUR_VALUE_HERE",
"CB_MCP_DISABLED_TOOLS": "YOUR_VALUE_HERE",
"CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "YOUR_VALUE_HERE",
"CB_MCP_LOG_LEVEL": "YOUR_VALUE_HERE",
"CB_MCP_LOG_SINKS": "YOUR_VALUE_HERE",
"CB_MCP_LOG_FILE": "YOUR_VALUE_HERE",
"CB_MCP_LOG_MAX_BYTES": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_JWKS_URI": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_ISSUER": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_AUDIENCE": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_ALGORITHM": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_MCP_BASE_URL": "YOUR_VALUE_HERE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-couchbase-mcp-server-couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_CONNECTION_STRING": "YOUR_VALUE_HERE",
"CB_USERNAME": "YOUR_VALUE_HERE",
"CB_PASSWORD": "YOUR_SECRET_VALUE",
"CB_CA_CERT_PATH": "YOUR_VALUE_HERE",
"CB_CLIENT_CERT_PATH": "YOUR_VALUE_HERE",
"CB_CLIENT_KEY_PATH": "YOUR_VALUE_HERE",
"CB_MCP_READ_ONLY_MODE": "YOUR_VALUE_HERE",
"CB_MCP_TRANSPORT": "YOUR_VALUE_HERE",
"CB_MCP_HOST": "YOUR_VALUE_HERE",
"CB_MCP_PORT": "YOUR_VALUE_HERE",
"CB_MCP_DISABLED_TOOLS": "YOUR_VALUE_HERE",
"CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "YOUR_VALUE_HERE",
"CB_MCP_LOG_LEVEL": "YOUR_VALUE_HERE",
"CB_MCP_LOG_SINKS": "YOUR_VALUE_HERE",
"CB_MCP_LOG_FILE": "YOUR_VALUE_HERE",
"CB_MCP_LOG_MAX_BYTES": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_JWKS_URI": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_ISSUER": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_AUDIENCE": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_JWT_ALGORITHM": "YOUR_VALUE_HERE",
"CB_MCP_OAUTH_MCP_BASE_URL": "YOUR_VALUE_HERE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
mcp-server-couchbase is an MCP server for Couchbase MCP Server - Enable AI agents to connect to and interact with Couchbase clusters.. It supports STDIO transport.
Use the generated config in Install. This server runs with uvx couchbase-mcp-server; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for uvx couchbase-mcp-server. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for uvx couchbase-mcp-server. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for uvx couchbase-mcp-server. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for uvx couchbase-mcp-server. Add required environment variables before starting Cursor or VS Code.
mcp-server-couchbase uses STDIO transport. Use the package or command config in Install.
mcp-server-couchbase inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
mcp-server-couchbase does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
couchbase-mcp-serverstdio | pypi | 1.0.0.post1 | Argument: --connection-string Argument: --username Argument: --password Argument: --ca-cert-path Argument: --client-cert-path Argument: --client-key-path Argument: --read-only-mode Argument: --transport Argument: --host Argument: --port Argument: --disabled-tools Argument: --confirmation-required-tools Argument: --log-level Argument: --log-sinks Argument: --log-file Argument: --log-max-bytes Argument: --oauth-jwks-uri Argument: --oauth-issuer Argument: --oauth-audience Argument: --oauth-algorithm Argument: --oauth-mcp-base-url Env: CB_CONNECTION_STRING Env: CB_USERNAME Env: CB_PASSWORD secret Env: CB_CA_CERT_PATH Env: CB_CLIENT_CERT_PATH Env: CB_CLIENT_KEY_PATH Env: CB_MCP_READ_ONLY_MODE Env: CB_MCP_TRANSPORT Env: CB_MCP_HOST Env: CB_MCP_PORT Env: CB_MCP_DISABLED_TOOLS Env: CB_MCP_CONFIRMATION_REQUIRED_TOOLS Env: CB_MCP_LOG_LEVEL Env: CB_MCP_LOG_SINKS Env: CB_MCP_LOG_FILE Env: CB_MCP_LOG_MAX_BYTES Env: CB_MCP_OAUTH_JWT_JWKS_URI Env: CB_MCP_OAUTH_JWT_ISSUER Env: CB_MCP_OAUTH_JWT_AUDIENCE Env: CB_MCP_OAUTH_JWT_ALGORITHM Env: CB_MCP_OAUTH_MCP_BASE_URL |
docker.io/couchbase/mcp-server:1.0.0.post1stdio | oci | Not captured | Env: CB_CONNECTION_STRING Env: CB_USERNAME Env: CB_PASSWORD secret Env: CB_CA_CERT_PATH Env: CB_CLIENT_CERT_PATH Env: CB_CLIENT_KEY_PATH Env: CB_MCP_READ_ONLY_MODE Env: CB_MCP_TRANSPORT Env: CB_MCP_HOST Env: CB_MCP_PORT Env: CB_MCP_DISABLED_TOOLS Env: CB_MCP_CONFIRMATION_REQUIRED_TOOLS Env: CB_MCP_LOG_LEVEL Env: CB_MCP_LOG_SINKS Env: CB_MCP_LOG_FILE Env: CB_MCP_LOG_MAX_BYTES Env: CB_MCP_OAUTH_JWT_JWKS_URI Env: CB_MCP_OAUTH_JWT_ISSUER Env: CB_MCP_OAUTH_JWT_AUDIENCE Env: CB_MCP_OAUTH_JWT_ALGORITHM Env: CB_MCP_OAUTH_MCP_BASE_URL |