Couchbase · Cursor

Add the Couchbase MCP server to Cursor

Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters.

Official serverLocalDatabases

1. Add the server

Paste into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

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

Scopes, env vars, OAuth and limits: Cursor MCP config guide

2. Sign in

Cursor prompts you to sign in the first time a remote OAuth server is used. Couchbase runs locally; set any credentials Couchbase asks for before starting Cursor.

3. Try it

Ask Cursor for something Couchbase can do. Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters. Approve the first tool call and check the result before allowing write actions automatically.

  • · Remote servers take a url; local servers take command and args.
  • · Values can reference ${env:NAME} so secrets stay out of the file.

Get the weekly agent stack update

New official MCP servers, spec changes and harness releases, checked against the source. One email a week, no fluff.

FAQ

How do I add the Couchbase MCP server to Cursor?
Run: { …. Cursor prompts you to sign in the first time a remote OAuth server is used.
Is this the official Couchbase MCP server?
Yes. It is published by Couchbase as io.github.couchbase/mcp-server-couchbase in the official MCP registry.
Does the Couchbase MCP server need an API key?
It runs locally from a package. See Couchbase's docs for any credentials it needs.

Links

Couchbase in other clients

More databases for Cursor

Work at Couchbase?

Feature Couchbase across the directory and its category from $49/month.

Feature this server

Reviewed Oct 19, 2026. Command generated from the registry record and checked against Cursor's documented syntax.