Google Calendar Bulk Event Deleter by Date Range

WHAT IT DOES

This tool helps you quickly delete multiple Google Calendar events within a specified date range. You enter a start and end date, and the script navigates to your calendar, loads events in that range, and displays them in a scrollable list with event titles, times, and checkboxes. You can then select which events to delete and execute the bulk deletion action. The script processes each selected event one at a time — navigating to the event details, clicking the delete button, and confirming the deletion. This is especially useful for cleaning up old calendar entries, removing automatically added events, or clearing out calendar data after a project ends.

WHERE IT RUNS

The script runs directly inside the Google Calendar web interface (calendar.google.com). It does not require a separate extension popup, background process, or external server. Everything happens within the page context, interacting with Google Calendar's React-based DOM components.

HOW TO USE

1. Navigate to Google Calendar (calendar.google.com).

2. Open the BotGentz panel.

3. Enter a start date and end date in YYYY-MM-DD format (e.g., 2025-01-01 to 2025-01-31).

4. Click "Scan & Delete" to start the process.

5. The script will navigate to the start date in your calendar, scroll through the view, and load events within the date range.

6. A list of events appears with checkboxes and details (title, time).

7. Select the events you want to delete (all are checked by default).

8. Click "Delete Selected Events" to begin. The script will open each event, click the More button, select Delete, and confirm the deletion.

9. Use "Ignore Selected" to add events to an ignore list so they are not shown in future scans.

TECHNICAL MECHANISM

Unlike Google Calendar's built-in deletion flow, this script operates purely on the public DOM of the Google Calendar interface. It uses date-based navigation by constructing a URL with the target date (e.g., calendar.google.com/calendar/u/0/r/day/2025/1/1) and loading the page. It then uses the calendar's grid view to locate events within the specified date range. Event elements are identified using selectors like `[role="gridcell"] [role="button"]` and `[data-event-id]`, with event titles and times extracted from nested elements. For deletion, the script uses event-driven interaction: it clicks an event to open the detail panel, clicks the More actions button (three dots), selects Delete from the menu, and clicks the confirm button. All actions include retry logic with spacing to account for Google Calendar's asynchronous rendering and to avoid triggering rate limiting.

THE PANEL

The tool appears as a draggable, resizable panel on the side of your screen. You can drag it to any position by clicking and holding the header, resize it by dragging the bottom-right corner, and collapse it to a small bubble when not in use. Press the Escape key to close the panel. The panel remembers its position and size per site (calendar.google.com) so it stays where you left it on your next visit.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not store any personal data except for a list of ignored event IDs, which is saved locally in your browser using GM_setValue. No data is sent to any external server. Google Calendar frequently updates its website, which may break the script. If you encounter issues, check for updates or contact support. Deleted events cannot be recovered — use with caution. The script will navigate your calendar view, which may disrupt your current view; it will return to the date you specified after scanning.