Skip to content
AgentAtlas

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",
        "operational"
      ]
    }
  }
}

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.

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

Built an MCP server? Get it listed everywhere →

Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →

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