How do I install the couchbase mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `CB_CONNECTION_STRING`, `CB_USERNAME`, `CB_PASSWORD`, `CB_CLIENT_CERT_PATH`, `CB_CLIENT_KEY_PATH`, `CB_MCP_DISABLED_TOOLS`, `CB_CA_CERT_PATH`, `CB_MCP_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Couchbase MCP Server

Interact with the data stored in Couchbase clusters using natural language.

Remote serverstreamable-httpPython

What is the Couchbase MCP Server?

Interact with the data stored in Couchbase clusters using natural language.

What you get

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.

Configuration and credentials

Python 3.10 or higher. - A running Couchbase cluster. The easiest way to get started is to use Capella free tier, which is fully managed version of Couchbase server. You can follow instructions to import one

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_server_configuration_status	Get the server status and configuration without connecting to the cluster — reports read-only mode, disabled/confirmation-required tools, OAuth settings, and the resolved logging configuration
test_cluster_connection	Check the cluster credentials by connecting to the cluster
get_cluster_health_and_services	Get cluster health status and list of all running services
get_buckets_in_cluster	Get a list of all the buckets in the cluster
get_scopes_in_bucket	Get a list of all the scopes in the specified bucket
get_collections_in_scope	Get a list of all the collections in a specified scope and bucket. Note that this tool requires the cluster to have Query service.
get_scopes_and_collections_in_bucket	Get a list of all the scopes and collections in the specified bucket
get_schema_for_collection	Get the structure for a collection
get_document_by_id	Get a document by ID from a specified scope and collection
upsert_document_by_id	Upsert a document by ID to a specified scope and collection. Disabled by default when CB_MCP_READ_ONLY_MODE=true.
insert_document_by_id	Insert a new document by ID (fails if document exists). Disabled by default when CB_MCP_READ_ONLY_MODE=true.
replace_document_by_id	Replace an existing document by ID (fails if document doesn't exist). Disabled by default when CB_MCP_READ_ONLY_MODE=true.
delete_document_by_id	Delete a document by ID from a specified scope and collection. Disabled by default when CB_MCP_READ_ONLY_MODE=true.
list_indexes	List all indexes in the cluster with their definitions, with optional filtering by bucket, scope, collection and index name. Set return_raw_index_stats=true to return the unprocessed index information.

How to install the Couchbase MCP Server

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "YOUR_CB_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.10 or higher. - A running Couchbase cluster. The easiest way to get started is to use Capella free tier, which is fully managed version of Couchbase server. You can follow instructions to import one

Variable	Description	Required
CB_CONNECTION_STRING	Declared in the maintainer’s client configuration.	Check documentation
CB_USERNAME	Declared in the maintainer’s client configuration.	Yes
CB_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Couchbase to get server configuration status.”
“Use Couchbase to test cluster connection.”
“Use Couchbase to get cluster health and services.”

Frequently asked questions

Interact with the data stored in Couchbase clusters using natural language. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.