Couchbase MCP Server

Name: Couchbase MCP Server
Author: Aniket310101

Aniket310101

Get started Repository

Lets LLMs work with Couchbase: query buckets, run N1QL queries and create, update or delete documents.

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-server-aniket310101 --env COUCHBASE_BUCKET='<COUCHBASE_BUCKET>' --env COUCHBASE_PASSWORD='<COUCHBASE_PASSWORD>' --env COUCHBASE_URL='<COUCHBASE_URL>' --env COUCHBASE_USERNAME='<COUCHBASE_USERNAME>' -- npx -y @couchbasedatabase/couchbase-mcp

~/.codex/config.toml

[mcp_servers.couchbase-server-aniket310101]
command = "npx"
args = ["-y", "@couchbasedatabase/couchbase-mcp"]
env = { COUCHBASE_BUCKET = "<COUCHBASE_BUCKET>", COUCHBASE_PASSWORD = "<COUCHBASE_PASSWORD>", COUCHBASE_URL = "<COUCHBASE_URL>", COUCHBASE_USERNAME = "<COUCHBASE_USERNAME>" }

# codex mcp add couchbase-server-aniket310101 --env COUCHBASE_BUCKET='<COUCHBASE_BUCKET>' --env COUCHBASE_PASSWORD='<COUCHBASE_PASSWORD>' --env COUCHBASE_URL='<COUCHBASE_URL>' --env COUCHBASE_USERNAME='<COUCHBASE_USERNAME>' -- npx -y @couchbasedatabase/couchbase-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "couchbase-server-aniket310101": {
      "command": "npx",
      "args": [
        "-y",
        "@couchbasedatabase/couchbase-mcp"
      ],
      "env": {
        "COUCHBASE_BUCKET": "<COUCHBASE_BUCKET>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>",
        "COUCHBASE_URL": "<COUCHBASE_URL>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "couchbase-server-aniket310101": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@couchbasedatabase/couchbase-mcp"
      ],
      "env": {
        "COUCHBASE_BUCKET": "<COUCHBASE_BUCKET>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>",
        "COUCHBASE_URL": "<COUCHBASE_URL>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "couchbase-server-aniket310101": {
      "command": "npx",
      "args": [
        "-y",
        "@couchbasedatabase/couchbase-mcp"
      ],
      "env": {
        "COUCHBASE_BUCKET": "<COUCHBASE_BUCKET>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>",
        "COUCHBASE_URL": "<COUCHBASE_URL>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "couchbase-server-aniket310101": {
      "command": "npx",
      "args": [
        "-y",
        "@couchbasedatabase/couchbase-mcp"
      ],
      "env": {
        "COUCHBASE_BUCKET": "<COUCHBASE_BUCKET>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>",
        "COUCHBASE_URL": "<COUCHBASE_URL>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "couchbase-server-aniket310101": {
      "command": "npx",
      "args": [
        "-y",
        "@couchbasedatabase/couchbase-mcp"
      ],
      "env": {
        "COUCHBASE_BUCKET": "<COUCHBASE_BUCKET>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>",
        "COUCHBASE_URL": "<COUCHBASE_URL>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>"
      }
    }
  }
}

Environment variables

COUCHBASE_BUCKET
COUCHBASE_PASSWORD
COUCHBASE_URL
COUCHBASE_USERNAME

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

Setup

Environment variables

Related