@cirqusde/google-calendar-sync

google-calendar-sync

Sync your private google calendar with your work google calendar.
Details of the event will be left out - it will only be visible as 'Private event' in your work calendar.

Setup

• Create a google cloud project (https://console.cloud.google.com/)
• Create a service account (https://console.cloud.google.com/iam-admin/serviceaccounts/create)
• Download a key for the service account (as JSON) and place it in google_calendar_key.json
• Create a file config.json and add the source and target calendar adresses
  • Add the email of your service account (client_email within your downloaded key) to both the source and target calendar
    • For the source calendar, read-only access is sufficient
    • For the target calendar, write access is required (your administrator might have to enable this in the Google Admin console)
  • Add a unique id to each source-target combination (this is used when multiple sources sync into the same target)
  • futureDays defaults to 14, pastDays to 7.
  • Instead of the source calendar, an ical link can be used as well
  • Example config:

  [
    {
    "id": "sync-id-1",
    "sourceCalendar": "[e-mail]",
    "targetCalendar": "[e-mail]",
    "futureDays": 180,
    "pastDays": 14
    },
    {
    "id": "sync-id-2",
    "sourceIcalLink": "https://ical-link.com",
    "targetCalendar": "[e-mail]",
    "futureDays": 180,
    "pastDays": 14,
    "label": "Some event title"
    }
  ]
  

• Run it with npx -y @cirqusde/google-calendar-sync (or even better: Add a cronjob to run it repeatedly)

Known caveats

• Google calendar does not manage event reminders per event but instead manages them per event & user:
  Multiple users that attend the same event can have different reminders, and a user can only manage its own reminders.
  As the events are created by a service account, the service account can only change its own reminders, not yours.
  All events created by the service account will have the default reminders for your calendar set. This might be fine for you with the default settings (10 mins before the event), but you also might want to remove the default reminder within your (work) calendar settings.

Publish to npm

• Bump version in package.json
• Run npm install
• Run npm publish --access public