Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Coverage Status npm version

Many Cloud is an open source utility that creates an interface for many cloud platforms found online that, after authentication, abstracts out which cloud service you are manipulating for the sake of simplicity. Many Cloud keeps things simple by automatically refreshing OAuth2 tokens and by providing an object-oriented approach to dealing with Files and Folders.


Steps to use: Firstly, you need to authenticate with whatever cloud services you will be using. For more information, see the authentication docs. Here is an example for authenticating with Google Drive:

//Initial authentication
let connection  = require("many-cloud").integration("GoogleDrive")({
	authentication_token:  authentication_token,
	redirect_uri:  redirect_uri

//Future authentication
let connection = require("many-cloud").integration("GoogleDrive")({
	access_token:  access_token,
	expiry_date:  expiry_date,
	refresh_token:  refresh_token,
	token_type:  "Bearer",
	force_reset:  true //Optionally forces a refresh of the access token

Authenticate the users with whatever integration you are using and then you will have access to the file/folder Abstractions. Here's an example:

//Require the folder abstraction
const Folder = require("many-cloud").abstraction("Folder");

//Get the root folder of our connection (to any of the supported drives)
let root_folder = new Folder("root", connection);

//List the files in the root folder
//This will return an array of File and Folder abstractions
let file_list = await root_folder.list_files();
//Download all of the files in the root folder (but not the folders)
for(let i = 0; i < file_list.length; i++) {
	if(file_list[i].type === 'file') {
		let name = await file_list[i].get_name();
		await file_list[i].download_to('some/local/storage/' + name);

Supported Cloud Services

Platform Supported
Google Drive Yes
Box Yes
S3 Yes
Dropbox To do
More to come!


A Node module for abstracting file management and interfacing with a variety of cloud storages. Currently a work in progress.




No packages published