How do I install Couchbase?

Couchbase is a local plugin. Install it using PyPI package: couchbase-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Couchbase need?

Couchbase requires the following credentials or environment variables: CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, CB_CA_CERT_PATH, CB_CLIENT_CERT_PATH, CB_CLIENT_KEY_PATH, CB_MCP_READ_ONLY_MODE, CB_MCP_READ_ONLY_QUERY_MODE, CB_MCP_TRANSPORT, CB_MCP_HOST, CB_MCP_PORT, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS. You can find setup instructions on the server detail page.

What AI apps work with Couchbase?

Couchbase uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Couchbase MCP Server

by Couchbase Ecosystem

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

Couchbase Model Context Protocol Server to interact with Couchbase clusters

About

Couchbase Model Context Protocol Server to interact with Couchbase clusters

What You'll Need

Set these up before or after installing:

Couchbase connection string. Required for connecting to the cluster.Optional

Environment variable: CB_CONNECTION_STRING

Couchbase database username. Required for basic authentication.Optional

Environment variable: CB_USERNAME

Couchbase database password. Required for basic authentication.Required

Environment variable: CB_PASSWORD

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.Optional

Environment variable: CB_CA_CERT_PATH

Couchbase client certificate path. Required for mTLS authentication.Optional

Environment variable: CB_CLIENT_CERT_PATH

Couchbase client key path. Required for mTLS authentication.Optional

Environment variable: CB_CLIENT_KEY_PATH

Couchbase read only mode. Set to true to allow disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.Optional

Environment variable: CB_MCP_READ_ONLY_MODE

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.Optional

Environment variable: CB_MCP_READ_ONLY_QUERY_MODE

Transport mode for the server (stdio, http or sse). Default is stdioOptional

Environment variable: CB_MCP_TRANSPORT

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.Optional

Environment variable: CB_MCP_HOST

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.Optional

Environment variable: CB_MCP_PORT

Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.Optional

Environment variable: CB_MCP_DISABLED_TOOLS

Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.Optional

Environment variable: CB_MCP_CONFIRMATION_REQUIRED_TOOLS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-couchbase-ecosystem-mcp-server-couchbase": {
      "env": {
        "CB_MCP_HOST": "your-cb-mcp-host-here",
        "CB_MCP_PORT": "your-cb-mcp-port-here",
        "CB_PASSWORD": "your-cb-password-here",
        "CB_USERNAME": "your-cb-username-here",
        "CB_CA_CERT_PATH": "your-cb-ca-cert-path-here",
        "CB_MCP_TRANSPORT": "your-cb-mcp-transport-here",
        "CB_CLIENT_KEY_PATH": "your-cb-client-key-path-here",
        "CB_CLIENT_CERT_PATH": "your-cb-client-cert-path-here",
        "CB_CONNECTION_STRING": "your-cb-connection-string-here",
        "CB_MCP_DISABLED_TOOLS": "your-cb-mcp-disabled-tools-here",
        "CB_MCP_READ_ONLY_MODE": "your-cb-mcp-read-only-mode-here",
        "CB_MCP_READ_ONLY_QUERY_MODE": "your-cb-mcp-read-only-query-mode-here",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-cb-mcp-confirmation-required-tools-here"
      },
      "args": [
        "couchbase-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Document Converter

Free

by xt765 · Developer Tools

Convert PDF, DOCX, HTML, Markdown, and Text for AI assistant context injection.

What You'll Need

Set these up before or after installing:

Couchbase connection string. Required for connecting to the cluster.Optional

Environment variable: CB_CONNECTION_STRING

Couchbase database username. Required for basic authentication.Optional

Environment variable: CB_USERNAME

Couchbase database password. Required for basic authentication.Required

Environment variable: CB_PASSWORD

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.Optional

Environment variable: CB_CA_CERT_PATH

Couchbase client certificate path. Required for mTLS authentication.Optional

Environment variable: CB_CLIENT_CERT_PATH

Couchbase client key path. Required for mTLS authentication.Optional

Environment variable: CB_CLIENT_KEY_PATH

Environment variable: CB_MCP_READ_ONLY_MODE

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.Optional

Environment variable: CB_MCP_READ_ONLY_QUERY_MODE

Transport mode for the server (stdio, http or sse). Default is stdioOptional

Environment variable: CB_MCP_TRANSPORT

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.Optional

Environment variable: CB_MCP_HOST

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.Optional

Environment variable: CB_MCP_PORT

Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.Optional

Environment variable: CB_MCP_DISABLED_TOOLS

Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.Optional

Environment variable: CB_MCP_CONFIRMATION_REQUIRED_TOOLS

{ "mcpServers": { "io-github-couchbase-ecosystem-mcp-server-couchbase": { "env": { "CB_MCP_HOST": "your-cb-mcp-host-here", "CB_MCP_PORT": "your-cb-mcp-port-here", "CB_PASSWORD": "your-cb-password-here", "CB_USERNAME": "your-cb-username-here", "CB_CA_CERT_PATH": "your-cb-ca-cert-path-here", "CB_MCP_TRANSPORT": "your-cb-mcp-transport-here", "CB_CLIENT_KEY_PATH": "your-cb-client-key-path-here", "CB_CLIENT_CERT_PATH": "your-cb-client-cert-path-here", "CB_CONNECTION_STRING": "your-cb-connection-string-here", "CB_MCP_DISABLED_TOOLS": "your-cb-mcp-disabled-tools-here", "CB_MCP_READ_ONLY_MODE": "your-cb-mcp-read-only-mode-here", "CB_MCP_READ_ONLY_QUERY_MODE": "your-cb-mcp-read-only-query-mode-here", "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-cb-mcp-confirmation-required-tools-here" }, "args": [ "couchbase-mcp-server" ], "command": "uvx" } } }

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Couchbase MCP Server

About

What You'll Need

How to Install

Security Report

Findings (1)

Reviews

No reviews yet

More Developer Tools MCP Servers

Toleno

mcp-creator-python

mcp-creator-typescript

FinAgent

MarkItDown

Document Converter

Couchbase MCP Server

About

What You'll Need

How to Install

Security Report

Findings (1)

Reviews

No reviews yet

More Developer Tools MCP Servers

Toleno

mcp-creator-python

mcp-creator-typescript

FinAgent

MarkItDown

Document Converter