node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Cross platform command line interface for DocumentDB

NOTE: All Pull-Requests must be made into the dev branch.

Build Status


You can install the documentdb-cli npm package.

npm install -g documentdb-cli

If you're more adventurous and like to live on the edge then you can install development version as follows:

git clone
cd documentdb-cli
git checkout dev
npm install -g

Get Started

To get the list of all parameters type 'documentdb -h'

  Usage: documentdb [options]
    -h, --help                     output usage information
    -V, --version                  output the version number
    -s, --server <server>          Server to conect to
    -k, --masterKey <key>          The master key to use for authentication
    -d, --database <database>      Database to connect to
    -l, --collection <collection>  Collection to query
    -q, --query <query>            The query to execute
    -f, --format <format>          The format of output [table, csv, xml, json]
    -c, --config <path>            Read connection information from config file

To connect to a DocumentDB instance invoke documentdb as follows

documentdb -s -k u1d0wTrlTWPVoA== -d mydatabase -l mycollection

You will get a prompt as follows:

Connecting to
documentdb-cli version 0.0.0
Enter ".help" for usage hints.

To get the list of all commands use the '.help' command

documentdb> .help
command            description
-----------------  ---------------------------------------
.help              Shows this message
.databases         Lists all the databases
.collections       Lists all the collections
.storedprocs       Lists all the stored procedures
.conflicts         Lists all the conflicts
.triggers          Lists all the triggers
.functions         Lists all the user defined functions
.permissions USER  Lists all the permissions
.attachments DOC   Lists all the attachments
.users             Lists all the users
.use db|coll ID    Switches current database or collection
.read FILENAME     Execute commands in a file
.quit              Exit the cli

To exit the cli use the '.quit' command

documentdb> .quit