Skip to content
⧖MCP-Bridge
Databases

Cosmos DB Claude Desktop Config

Add the Cosmos DB MCP server to Claude Desktop with this ready-to-use configuration.

Setup Instructions

  1. Open Claude Desktop
  2. Go to Settings → Developer → Edit Config → claude_desktop_config.json
  3. Paste the JSON below into the file
  4. Set your credentials in the env section
  5. Restart Claude Desktop

Configuration JSON

Copy the entire block into your claude_desktop_config.json

{
  "mcpServers": {
    "azure-com-cosmos-db": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp/azure-com-cosmos-db"
      ],
      "env": {
        "COSMOS_DB_API_KEY": "your_cosmos_db_api_key"
      }
    }
  }
}

Environment Variables

COSMOS_DB_API_KEY

Replace your_cosmos_db_api_key with your actual cosmos db api key

Endpoints

GET/providers/Microsoft.DocumentDB/operations

Operations_List

GET/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/databaseAccounts

DatabaseAccounts_List

GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts

DatabaseAccounts_ListByResourceGroup

GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}

DatabaseAccounts_Get

PUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}

DatabaseAccounts_CreateOrUpdate

DELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}

DatabaseAccounts_Delete

PATCH/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}

DatabaseAccounts_Patch

GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/apis/cassandra/keyspaces

DatabaseAccounts_ListCassandraKeyspaces

GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/apis/cassandra/keyspaces/{keyspaceName}

DatabaseAccounts_GetCassandraKeyspace

PUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/apis/cassandra/keyspaces/{keyspaceName}

DatabaseAccounts_CreateUpdateCassandraKeyspace