https://github.com/gboeing/outlook-to-google-calendar

One-way sync from an outlook calendar to a google calendar, handling new, updated, and deleted events.
https://github.com/gboeing/outlook-to-google-calendar

Last synced: about 2 months ago
JSON representation

One-way sync from an outlook calendar to a google calendar, handling new, updated, and deleted events.

• Host: GitHub
• URL: https://github.com/gboeing/outlook-to-google-calendar
• Owner: gboeing
• License: mit
• Created: 2020-07-03T19:50:21.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-08-11T17:27:09.000Z (over 3 years ago)
• Last Synced: 2024-10-12T15:06:04.755Z (2 months ago)
• Language: Python
• Size: 22.5 KB
• Stars: 64
• Watchers: 6
• Forks: 19
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - gboeing/outlook-to-google-calendar - One-way sync from an outlook calendar to a google calendar, handling new, updated, and deleted events. (Python)

README

        
# Microsoft Office 365 calendar -> Google calendar

## Overview

One-way sync from a Microsoft Office 365 Outlook calendar to a Google calendar, handling new, updated, and deleted events.

The script connects to the Microsoft API using the [O365 package](https://github.com/O365/python-o365#calendar) and connects to the Google API using its [Python client](https://developers.google.com/calendar/api/quickstart/python). Familiarize yourself with their documentation as you may need to enable APIs or create credentials per their instructions before you begin. See also the Google Calendar API [reference](https://developers.google.com/calendar/v3/reference/events).

## Setup

  - Create `config.py` (you can adapt [`config_sample.py`](config_sample.py)) to hold your personal configuration details, include your Microsoft `client_id` and `client_secret` and your Google calendar ID.

      - **Create a new Google calendar just for this application, or else your existing events will be deleted!**

      - Create Google credentials for this application (see overview section above) and save as `credentials/google_credentials.json`.

      - Get the Microsoft `client_id` and `client_secret` by following the O365 [instructions](https://github.com/O365/python-o365#authentication) on how to authenticate on behalf of a user.

  - Run `pip install --upgrade -r requirements.txt` to install the [required Python dependencies](requirements.txt).

  - In the [credentials folder](credentials), run [`python quickstart.py`](credentials/quickstart.py) to create a Google API access token.

  - Microsoft API access token is created interactively via URL on first run, then permanently stored. It expires in 90 days *if* you don't run the script within that time.

  - On your server, set up a cron job to run [`outlook_to_google.py`](outlook_to_google.py) (using [run.sh](run.sh)) every 15 minutes (or however often you need).

  - The script will check Microsoft for calendar events and compare them to the calendar events it saved (in events_ts.json) during the previous run. **If they differ (in IDs or timestamps), it will delete all events on this Google calendar and then add all Microsoft calendar events to the Google calendar.**