FAQ

Can I export event names as a column?

Yes. Event names (titles) are exported under the summary column — not "name" or "title". When you pull the List of events entity, you'll see a summary field for each row containing the event title.

Will editing the spreadsheet change my Google Calendar?

No. Coupler.io is a one-way data export. Editing your Google Sheets, Excel, or any other destination will never affect the events in your Google Calendar.

Why can I only pull data from the last 4 weeks?

This is a limitation of the Google Calendar API, not Coupler.io. The earliest available date for event extraction is 4 weeks ago. To maintain a longer history, enable Append mode in your destination settings so each run adds new data on top of previously exported rows rather than overwriting them.

Can I pull future calendar events?

Yes. Set your End date to a future date using the date picker. Coupler.io supports future date ranges, so you can pull upcoming events as far ahead as you need.

Why do recurring events show the wrong date?

Recurring events often return the original creation date rather than the actual occurrence date within your selected date range. This is a known behavior of the Google Calendar API. Double-check recurring event dates against your calendar, and use the Updated since filter to catch recently modified events if needed.

Why are times off by one hour from what I see in Google Calendar?

This is usually a daylight saving time (DST) issue. The start.dateTime field includes timezone information, but if your destination applies a static UTC offset, it won't account for DST shifts. Check your timezone settings in your destination and adjust any date conversion formulas to use the correct local offset.

Can I pull data from multiple calendars at once?

For the Free/Busy report, yes — you can specify multiple calendars in one source. For Events, each source is limited to one calendar. To combine events from multiple calendars, add multiple sources to the same data flow and use the Append transformation to merge them into one dataset.

How do I filter events to only those with attendees?

The attendees field doesn't support direct filtering through the advanced filter interface — using it there will throw an error. Instead, export all events and filter on the attendees column in your destination using a formula (e.g., in Google Sheets) or a query (e.g., in BigQuery).

Can I use Google Calendar data in AI tools like ChatGPT or Claude?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. You can route your calendar data directly to these tools to generate schedule summaries, identify patterns, or answer questions about your events.

How do I categorize events by type using color labels?

Each event has a colorId field that corresponds to the color label set in Google Calendar. You can use this field in a calculated column or formula to assign categories — for example, mapping colorId=3 to "Client Meeting" or colorId=4 to "Focus Time".

For a full list of available fields and what they contain, see the Data Overview article. For setup tips and avoiding common mistakes, check Best Practices. Running into an error? See Common Issues.