Google Contacts birthday to iCal calendar converter

This commandline tool converts birthday events of an CSV export of Google Contacts via Google Takeout into a iCal calendar file.

The iCal calendar file can then be imported into Google Calendar to create notifications for birthdays of your contacts.

Install dependencies

Install needed dependencies via Poetry

$ make install-dependencies

Usage

Run tool from commandline

$ cd google_contacts_birthday_ical_calendar/
$ poetry shell
$ ./converter.py --help

Usage: converter.py [OPTIONS] CSVFILE ICALFILE

    Commandline interface for Google Contacts birthday to iCal calendar
    converter

    CSVFILE is the input .csv filepath.
    ICALFILE is the output .ics filepath.

Options:
    --verbose  Enable verbose logging output.
    --help     Show this message and exit.

Docker

Build Docker image

$ make build-docker-image

Run Docker container from built image to print help

$ docker run google_contacts_birthday_ical_calendar:latest

Run Docker container from built image with additional arguments

$ docker run \
    --volume=$(pwd):/data:rw \
    google_contacts_birthday_ical_calendar:latest \
    example.csv \
    example.ics \
    --verbose

Other projects

• Google Apps Script which sends emails for birthdays of Google contacts GoogleContactsEventsNotifier

Contribute

Please note the separate contributing guide.

License

MIT