Server Couchbase MCP Server - install & status [2026]

01 · Install Server Couchbase

before you install - you'll need

Set CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, CB_CLIENT_CERT_PATH, CB_CLIENT_KEY_PATH, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS, CB_MCP_TRANSPORT, CB_MCP_CONFIRMATION before connecting. CB_MCP_READ_ONLY_MODE is optional or environment-specific per the README.

Claude Code

claude mcp add couchbase-mcp-server-couchbase -- uvx couchbase-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "couchbase-mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license Apache-2.0 - declared in the repository

pypi package couchbase-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.couchbase is GitHub-verified and matches the repo owner

03 · What Server Couchbase can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Limitations (from the README)

> Warning: Disabling tools alone does not guarantee that certain operations cannot be performed. The underlying database user's RBAC (Role-Based Access Control) permissions are the authoritative security control. > > For example, even if you disable upsert_document_by_id and delete_document_by_id, data modifications can still occur via the run_sql_plus_plus_query tool using SQL++ DML statements (INSERT, UPDATE, DELET

Latest releases

v1.0.1 · 2026-08-13

Fixing Accuracy Test Build · Version 1.0 post1 · Move Validation to RestAPI path · Support Custom scopes in Authentication · Da 1945 handle within any exists in parser · Update Dependencies · DA-1951 Added Logging…

v1.0.0.post1 · 2026-06-30

Fixing Accuracy Test Build · Version 1.0 post1

v1.0.0 · 2026-06-26

Build docs for all PRs · Split documentation and related Configuration · Update repository links to use the correct GitHub organization slug · Migrate MCP Registry Docker Image by releasing new RC · Build new version…

04 · Who maintains Server Couchbase

mcp-server-couchbase is maintained by couchbase. It's the only MCP server we track from this author; the repo dates to Mar 2025.

05 · Facts

repository: github.com/couchbase/mcp-server-couchbase
website: https://mcp-server.couchbase.com/
category: database - ranked #22 of 151 actively-maintained database servers as of 2026-08-25.
release cadence: 5 releases in the last 90 days (latest 2026-08-13)
registry: io.github.couchbase/mcp-server-couchbase (active, first published 2026-06-18 · 5 versions)
packages: pypi:couchbase-mcp-server · oci:docker.io/couchbase/mcp-server:1.0.1

06 · Server Couchbase FAQ

What is Server Couchbase?

Couchbase MCP Server is a self-hosted MCP Server that allows AI agents to connect to and interact with data in Couchbase clusters, whether hosted on Capella or self-managed. It provides tools across categories including Cluster Health, Data Schema, Key-Value, Query, and Performance - with safety controls via read-only mode and fine-grained tool disabling. It supports both STDIO and Streamable HTTP transports.

Is Server Couchbase still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 5 releases in the last 90 days. We re-verify nightly.

How do I install Server Couchbase?

Run `uvx couchbase-mcp-server`. The README documents 10 environment variables (CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD…) to set first. Set CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, CB_CLIENT_CERT_PATH, CB_CLIENT_KEY_PATH, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS, CB_MCP_TRANSPORT, CB_MCP_CONFIRMATION before connecting. CB_MCP_READ_ONLY_MODE is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Server Couchbase run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Server Couchbase

Alternatives to Server Couchbase

Maintained database servers if Server Couchbase isn't the fit.

Pairs well with

Servers that cover what Server Couchbase doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Ensembl MCP Server · Faa Aircraft Registry MCP Server · Data Charter · Dbatools MCP Server · Dbtrail

More Python MCP servers · Cronometer · Elasticsearch MCP Server · VerifiMind PEAS - RefleXion Trinity · CrowdStrike Falcon MCP Server · Trentina · see all