Azure Cosmos Db Assistant

Azure Cosmos DB Plugin for Claude Code

The Azure Cosmos DB plugin for Claude Code gives Claude deep expertise in Azure Cosmos DB best practices, data modeling, query optimization, and SDK usage — ready to use immediately after install with no configuration required.

Install

Install from the official Anthropic marketplace:

/plugin install azure-cosmos-db-assistant@claude-plugins-official
/reload-plugins

Note: Earlier versions of this plugin used the namespace /azure-cosmosdb:*. The plugin now uses /azure-cosmos-db-assistant:* to align with the official marketplace entry and improve discoverability.

Works Out of the Box

This plugin installs cleanly with no required environment variables, no external services, and no auto-running binaries. All skills, the expert agent, and commands are available immediately.

What's Included

• Skills — 73 best-practice rules across 10 categories covering data modeling, partition key design, query optimization, SDK patterns, indexing, throughput, global distribution, monitoring, design patterns, and vector search — sourced from the cosmosdb-agent-kit
• Agent — A specialized Cosmos DB expert agent for in-depth guidance
• Commands — Code review and skill regeneration commands

Optional: MCP Toolkit Integration

For users who want to connect Claude Code to a live Azure Cosmos DB account, the optional Azure Cosmos DB MCP Toolkit integration adds database operations, schema discovery, and vector search. This requires a separate deployment and is not required for the plugin to function.

See SETUP.md for full integration instructions.

Getting Started

After installing the plugin, try these in Claude Code:

Commands

/azure-cosmos-db-assistant:cosmos-review     # Review your code for Cosmos DB best practices
/azure-cosmos-db-assistant:generate-skills   # Regenerate skills from upstream agent-kit
/azure-cosmos-db-assistant:cosmos-setup      # Configure optional MCP Toolkit connection

Agent

/agents cosmosdb-expert

Example Questions