Couchbase MCP Server

Databasestdio
Repository

Community-supported MCP server from the Couchbase ecosystem that lets AI assistants interact with data in Couchbase clusters and Capella. Exposes tools to browse scopes and collections, run SQL++ (N1QL) queries, and read or modify documents, with authentication and safety controls enforced by the server. Useful for conversational data exploration and operational queries against Couchbase.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": [],
      "env": {
        "CB_CONNECTION_STRING": "<YOUR_CB_CONNECTION_STRING>",
        "CB_USERNAME": "<YOUR_CB_USERNAME>",
        "CB_PASSWORD": "<YOUR_CB_PASSWORD>",
        "CB_BUCKET_NAME": "<YOUR_CB_BUCKET_NAME>"
      }
    }
  }
}

Tools (2)

run_sql_plus_plus_query

Execute a SQL++ (N1QL) query against the configured Couchbase bucket.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "SQL++ query to run"
    }
  }
}

get_document_by_id

Retrieve a document from a collection by its key.

{
  "type": "object",
  "required": [
    "scope",
    "collection",
    "document_id"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "description": "Scope name"
    },
    "collection": {
      "type": "string",
      "description": "Collection name"
    },
    "document_id": {
      "type": "string",
      "description": "Key of the document to fetch"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author
Couchbase Ecosystem (@Couchbase-Ecosystem)
Repository
https://github.com/Couchbase-Ecosystem/mcp-server-couchbase
Stars
0
Last Updated
July 12, 2026