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.
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.
Reviewed Oct 19, 2026. Command generated from the registry record and checked against Cursor's documented syntax.