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.

Usage

Build Docker image

$ make build-docker-image

Run Docker container from built image to print help

$ make run-docker-image

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.

Run Docker container from built image with custom arguments

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

Development

Build and launch the DevContainer in VSCode.

Other projects

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

Contribute

Please note the separate contributing guide.

License

MIT

escalate / google-contacts-birthday-ical-calendar

readme