Server Couchbase MCP Server

Couchbase MCP Server is a self-hosted Model Context Protocol (MCP) server that connects AI agents and LLM-powered assistants - Claude, Cursor, Windsurf, VS Code Copilot, and other MCP clients - to data in Couchbase clusters, whether hosted on Capella or self-managed. MCP is an open standard for letting AI assistants call tools and query external data sources; this server implements that standard for Couchbase, so an…

People who work with couchbase, capella and database and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 34 · #25 OF 168 MAINTAINED DATABASE · VERIFIED 2026-09-18

Apache-2.0 · Python servers · how we verify → /methodology

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 before connecting.

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.post1 · 2026-08-25

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

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 #25 of 168 actively-maintained database servers as of 2026-09-18.
release cadence: 4 releases in the last 90 days (latest 2026-08-25)
registry: io.github.couchbase/mcp-server-couchbase (active, first published 2026-06-18 · 10 versions)
packages: pypi:couchbase-mcp-server · oci:docker.io/couchbase/mcp-server:1.0.1

06 · Server Couchbase FAQ

What is Server Couchbase?

Is Server Couchbase still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 4 releases in the last 90 days. We re-verify nightly.

How do I install Server Couchbase?

Run `uvx couchbase-mcp-server`. The README documents 7 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 before connecting. 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 · SQL Server MCP · Ensembl MCP Server · Faa Aircraft Registry MCP Server · Faostat MCP Server · Data Charter

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