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

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

Download a range of dates by deselecting the option "All Events" and choosing a start and end date. With a range of dates all events in the range will be downloaded, including occurrences of repeat events within the period. When you use "All Events" repeat events are represented as a single row with repeat options, and editing them will affect the entire series. Any edited events in the series ("exceptions") will also show up in their own row and can be edited individually.

A free licence allows from our website allows you to fetch changes made to the calendar using "Import Changes &  New Events" without recreating the Sheet up to 10 times per day, import up to 5000 calendar events per day, and perform up to 200 calendar edits per day. If you do not create a free account you will be limited to importing 2000 events per day, 50 update/deletes and using "Import Changes & New Events" 3 times per day. Upgrade to a paid licence to remove all limits to Import and Export.

Each Sheets2GCal Sheet 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 so please use the sidebar first a few times to ensure your settings are correct.

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" or "Delete" columns checked will be updated in the Calendar, so if you use formulas to automatically 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. With the option "Overwrite newer calendar data" disabled you can prevent unwanted edits to the calendar in case events have been edited in the calendar since the last Sheet import.

"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 not 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. You can also use a formula for the Description column that pulls in data from another Sheet, for example, and importing calendar changes to other event properties will not overwrite the formula.

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.

In the Advanced menu there are several options for managing the Sheet and your account.

Sheets2GCal v2 adds column tracking that allows you to move and rename columns freely, but you should first use Advanced > Sheet Doctor to upgrade Sheets that were created before this date. Follow the instructions provided to add any missing columns, fix data validation errors and import any missing data.

Sheet Doctor is a new tool to repair any errors with the column management system. It can add any missing essential columns, fix data validation (date formats, colour names, repeat types etc.) and optionally fetch any missing data for the columns you have repaired.

"Update Language" will convert the Sheet and Sheets2GCal to your Google Language Setting (English, French, Italian, Hebrew, Arabic and Japanese).

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, and you can edit the frequency for the "trigger" at https://script.google.com/home/triggers if you want it to happen more often, but it is not recommended to create/delete triggers directly there as Sheets2GCal will not be aware of any changes you have made.

"Automatic Export/Import" first exports all rows that do not match the calendar event, then imports changes made to the calendar. Events modified in the calendar will NOT be overwritten if modified in the calendar since the last import for sheets created since 18 Aug 2025, sheets where you have used "Import Changes" and sheets that have been repaired with Sheet Doctor.

Google limits the amount of data that can be processed without the  user present, so you may run into problems using these options with large calendars. Events that have been successfully processed will  be coloured green, deleted events will be marked in red and the data removed according to your "Export" Settings.

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™. For problems with Sheets™ you can always recover an earlier version using versioning.

"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™

AUG 17-21 2025: Sheets2GCal v2 major update:
New free/registered options: limited Import Changes & New Events
Batch sheet processing for all Import Changes
Advanced column management using metadata: move, rename any column
Sheet Doctor: repair columns, data validation, import missing data
ETag support for efficient syncing
Option to prevent overwriting newer calendar data
Event status and IDs used for faster "import changes"
Patch existing row data to better preserve user data
Improved onEdit for speed and reliability
Improved Sheet language detection
"Force Import Sync" option to resync the Sheet
Improved layout for smaller screens.
Membership caching improves speed