📊 A Google Drive spreadsheet simple database
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Build Status Coverage Status


A Google Drive spreadsheet simple database. Stop wasting your time when a simple table is enough. Perfect for collaboration with multiple people editing the same spreadsheet.

id firstname lastname age city
1 John Smith 34 San Francisco
2 Merry Johnson 19 Tokyo
3 Peter Williams 45 London

Becomes a JSON file and an array of objects in your code:

    "id": "1",
    "firstname": "John",
    "lastname": "Smith",
    "age": "34",
    "city": "San Francisco"
    "id": "2",
    "firstname": "Merry",
    "lastname": "Johnson",
    "age": "19",
    "city": "Tokyo"
    "id": "3",
    "firstname": "Peter",
    "lastname": "Williams",
    "age": "45",
    "city": "London"


To access it with the default configuration you just need to provide the Google Drive's sheet id. Read more in the full documentation, but here's an example:

// Include the module and tell it which spreadsheet to use
var drive = require("drive-db")("1BfDC-ryuqahvAVKFpu21KytkBWsFDSV4clNex4F1AXc");

// Load the spreadsheet
drive.load().then(db => {

  // Find all Johns by their last name
  var Johns = db.find({ firstname: "John" }).order('lastname');

The db.find() queries are the same as in mongoDB's comparison query operators:

// Return an array with one element that has the id 3
db.find({ id: 3 });

// Return an array of people called "John" or "Jack"
db.find({ firstname: { $in: ["John", "Jack"]] } });


npm install drive-db --save

To get the right Google Drive spreadsheet:

// Single argument can be passed as that

// If you want to add more options
require('drive-db')({ sheet: '1fvz34wY6phWDJsuIneqvOoZRPfo6CfJyPg1BYgHt59k' });

// Load it later on
var drive = require('drive-db')();
drive.sheet = '1BfDC-ryuqahvAVKFpu21KytkBWsFDSV4clNex4F1AXc';

The table has to have a structure similar to this, where the first row are the alphanumeric field names:

id firstname lastname age city
1 John Smith 34 San Francisco
2 Merry Johnson 19 Tokyo
3 Peter Williams 45 London

See this document as an example. Please do not request access to edit it.


To run the tests, simply call:

npm test


Please take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

Areas where I'm seeking for help:

  • Testing. Adding coverage or improving existing ones.
  • Documentation. Make everything clear.

Thanks to