Skip to content
List free blocks of time from your Google Calendar in your CLI
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


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


A Node.js CLI utility to retrieve available time slots on your Google Calendar.


  1. Node.js & NPM
  2. Knowledge of Google API's (e.g., ability to create an application in Google Developer Console, add an API, generate OAuth Credentials)


Running this application for the first time:

  1. Follow this tutorial to generate a Google Calendar API:
  2. $ git clone amifree/
  3. $ cd amifree/
  4. $ npm install
  5. $ bin/amifree setup

The Goal:

When the application is complete, the user will be able to:

  1. Run npm install amifree
  2. Run amifree setup
  3. Application lists out steps to generate an appropriate Google OAuth application, read credentials.json file, and asks you for the Google Calendar ID of the calendar you want to read.
  4. Run amifree for a list of available time slots from the Google Calendar associated with the Google Calendar ID above.

To Do:

  • Refactor to use Moment.jss
  • If credentials.json file already exists and user runs amifree setup, ask "Would you like to overwrite your current credentials file?"
  • amifree --this week: As well as other commands like this, I want the user to be able to query their calendar for a wider range of dates
  • amifree --changeCalendarID Allows user to change the Google Calendar ID you want to read from.

Issues/Security Concerns:

  • Right now, all users are forced to create their own Google API credentials for this project. I'm not sure there's any better way to do this given the way that OAuth 2.0 is written, but any and all PR's are welcome.
  • I thought I could make a solution without Moment.js, but turns out Moment.js just has too many useful utils that I could incorporate.
You can’t perform that action at this time.