Couchbase MCP Server

Name: Couchbase MCP Server
Author: Couchbase

CouchbaseOfficial

Get started Repository Website & docs

Connects agents to Couchbase Capella and self-managed clusters for document operations and SQL++ queries.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add couchbase --env CB_PASSWORD='<CB_PASSWORD>' --env CB_CONNECTION_STRING='<CB_CONNECTION_STRING>' --env CB_USERNAME='<CB_USERNAME>' --env CB_BUCKET_NAME='<CB_BUCKET_NAME>' -- uvx couchbase-mcp-server

~/.codex/config.toml

[mcp_servers.couchbase]
command = "uvx"
args = ["couchbase-mcp-server"]
env = { CB_PASSWORD = "<CB_PASSWORD>", CB_CONNECTION_STRING = "<CB_CONNECTION_STRING>", CB_USERNAME = "<CB_USERNAME>", CB_BUCKET_NAME = "<CB_BUCKET_NAME>" }

# codex mcp add couchbase --env CB_PASSWORD='<CB_PASSWORD>' --env CB_CONNECTION_STRING='<CB_CONNECTION_STRING>' --env CB_USERNAME='<CB_USERNAME>' --env CB_BUCKET_NAME='<CB_BUCKET_NAME>' -- uvx couchbase-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<CB_PASSWORD>",
        "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
        "CB_USERNAME": "<CB_USERNAME>",
        "CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
      }
    }
  }
}

.vscode/mcp.json

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

~/.gemini/settings.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<CB_PASSWORD>",
        "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
        "CB_USERNAME": "<CB_USERNAME>",
        "CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<CB_PASSWORD>",
        "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
        "CB_USERNAME": "<CB_USERNAME>",
        "CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_PASSWORD": "<CB_PASSWORD>",
        "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
        "CB_USERNAME": "<CB_USERNAME>",
        "CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
      }
    }
  }
}

Environment variables

CB_PASSWORD
CB_CONNECTION_STRING
CB_USERNAME
CB_BUCKET_NAME

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related