Sheets2GCal is a Google Sheets™ Add-on for managing Google Calendar™ Events.

To get started after installing, go to the Google Sheets™ “Add-Ons” menu and click either “Import Calendar to Sheet” to import events from a Google Calendar™, or “Configure Sheet” and set up a new blank Sheet for use with Sheets2GCal using "Link Sheet".

Paid members can download and sync ranges of dates by deselecting  the option "All  Events" and choosing a start and end date. All events in the range will be downloaded, including occurrences of repeat events within the period. 

A paid licence also allows you to fetch only changes made to the calendar using "Import Changes and  New Events" without recreating the Sheet. Please note that changing the date range before importing new updates will take longer as all additional events must be downloaded. A free membership allows you to import up to 5000 calendar events per day, and perform up to 1000 calendar edits per day.

Each Sheets2GCal is associated with a single Google calendar for which you should have read/write access. In Google Sheets™ every "SpreadSheet" is a collection of "Sheets". Once you have created a Spreadsheet for Sheets2GCal, use the small "+" icon bottom-left to create new sheets within the same document - that way you can easily move between the tabs at the bottom, each of which can be connected to a different Google calendar, without having to close and open a new document.

Quick Import, Quick Export and Quick Export/Import menu items are shortcuts for Import, Export and "Export then Import" without having to open the add-on sidebar. These use the default settings you last used to import/export changes made to your calendar/sheet.

When events are created/exported from the Sheet or imported from Google Calendar™ they are linked (using a hidden Event ID column), and can be updated or deleted directly from the Sheet using "Export Sheet to Calendar". Click an event’s “Link” in that column to open the event in Google Calendar™.

Only events with the "Update" column checked will be updated in the Calendar, so if you use formulas to populate calendar data you will need to use "Check Sheet vs Calendar" to first check the "Update" box for all rows that do not match the corresponding Google Calendar™ event. Please note that this also detects differences caused  by edits made in Google Calendar™, so be careful not to overwrite edits made directly in your calendars.

"Import All" and  "Export All" will perform Quick Import and Quick Export for all your Sheets in the Spreadsheet which are linked to Google Calendar™.

To create new events you must enter at least the Title and Start Date for All-Day events, or Title, Start Date and Start Time for timed events.

Enter new events manually, or copy/paste rows/columns from other spreadsheets into the correct columns, check the “Update” checkbox for the events you wish to create, then click “Update {Calendar Name}” to save the events to that Google Calendar™.

You can also use formulas to populate calendars with data from your own additional columns, or even  other sheets. Cells containing formulas are no longer affected by Importing or Exporting, so you could add a "Duration" column to calculate the difference between Start and End times, for example, and the formula would continue to work when events are edited in Google Calendar™, or when new events  are imported.

Add a list of emails separated by commas in the ‘Guests’ field and these Guests will be added to the event. Once uploaded to Google this field will show the full Guests JSON data including guest responses. This data can be edited and saved to Google, but you must preserve JSON formatting and you cannot edit other guest replies. Check the “Send Notifications” checkboxes if you want notifications sent out to Guests for new events (future events only), or updates to existing events.

Add a Google MEET™ to any event by typing any text(e.g "YES") into the "Meet" column before updating the event in Google Calendar™. When the event is created/updated the text  will be automatically replaced by the link to the meeting.

Use "Automatic Import/Export" to schedule a daily import/export of any changes made to Google Calendar™ to one or several Sheets2GCal Sheets in a given Spreadsheet, followed by an update to Google Calendar™ with any sheet rows that do not match the calendar events.

"Automatic Import/Export" first imports changes made to the Google calendar, then checks for differences between the updated sheet and the calendar before updating the events in the calendar which don't match the sheet. You can set this to happen once per day for multiple sheets in a given spreadsheet.

Please use this option with caution: Google limits the amount of data that can be processed without the  user present, so you may run into problems with large calendars. Events that have been successfully processed will  be  coloured green.

Creating events in Google Calendar™ from Google Sheets™ is free for all users, but free members can perform up to 1000 calendar edits per day. To import events you need to sign up for a FREE account on 
 https://www.sheets2gcal.com. This will allow you to import up to 5000 events per day. To import a date-range, changes made to Google Calendar™ ("Import Changes and New Events") or for heavy usage please purchase a subscription.

Google Workspace™ users in a custom domain may buy individual subscriptions, or a "Domain" subscription to allow all users on the domain to use the unlimited version of Sheets2GCal. For more than 5 users a "Domain" subscription will save you money.

The developer may not be held responsible for any problems caused directly or indirectly by the software. It is the user’s responsibility to ensure they have regular backups of Google Calendar™/Sheets™.

"https://www.googleapis.com/auth/userinfo.email"
Required by all add-ons to identify the user.

"https://www.googleapis.com/auth/calendar.readonly"
Required to read calendar event data for import to your Sheet

"https://www.googleapis.com/auth/spreadsheets.currentonly"
Required to access the current Sheet in which you are using Sheets2GCal

"https://www.googleapis.com/auth/calendar.events"
Required to update and delete events based on your sheet

"https://www.googleapis.com/auth/script.container.ui"
Required by all Google Workspace™ add-ons

"https://www.googleapis.com/auth/script.external_request",
Required to check your membership status.

"https://www.googleapis.com/auth/script.scriptapp"
Required to set up automatic imports of Google Calendar™ into your Google Sheets™

"https://www.googleapis.com/auth/spreadsheets"
Required to run automatic imports of Google Calendar into your Google Sheets™