Couchbase · Claude Code
Add the Couchbase MCP server to Claude Code
Explore Couchbase buckets and schemas, run SQL++ and vector queries, and analyze query performance on Capella or self-managed clusters.
1. Add the server
Run in your terminal
claude mcp add couchbase -- uvx couchbase-mcp-server
Scopes, env vars, OAuth and limits: Claude Code MCP config guide
2. Sign in
Run /mcp inside Claude Code to sign in to remote servers that use OAuth. Couchbase runs locally; set any credentials Couchbase asks for before starting Claude Code.
3. Try it
Ask Claude Code 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.
- · Add --scope project to share a server with your team through .mcp.json in the repo.
- · Use claude mcp list to see what is connected and claude mcp remove <name> to drop one.
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 Claude Code?
- Run: claude mcp add couchbase -- uvx couchbase-mcp-server. Run /mcp inside Claude Code to sign in to remote servers that use OAuth.
- 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 Claude Code
Work at Couchbase?
Feature Couchbase across the directory and its category from $49/month.
Reviewed Oct 19, 2026. Command generated from the registry record and checked against Claude Code's documented syntax.