# FAQ

<details>

<summary>Can I export event names as a column?</summary>

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.

</details>

<details>

<summary>Will editing the spreadsheet change my Google Calendar?</summary>

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.

</details>

<details>

<summary>Why can I only pull data from the last 4 weeks?</summary>

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.

</details>

<details>

<summary>Can I pull future calendar events?</summary>

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.

</details>

<details>

<summary>Why do recurring events show the wrong date?</summary>

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.

</details>

<details>

<summary>Why are times off by one hour from what I see in Google Calendar?</summary>

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.

</details>

<details>

<summary>Can I pull data from multiple calendars at once?</summary>

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.

</details>

<details>

<summary>How do I filter events to only those with attendees?</summary>

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).

</details>

<details>

<summary>Can I use Google Calendar data in AI tools like ChatGPT or Claude?</summary>

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.

</details>

<details>

<summary>How do I categorize events by type using color labels?</summary>

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

</details>

{% hint style="info" %}
For a full list of available fields and what they contain, see the [Data Overview](/sources/category/project-management/google-calendar/data-overview.md) article. For setup tips and avoiding common mistakes, check [Best Practices](/sources/category/project-management/google-calendar/best-practices.md). Running into an error? See [Common Issues](/sources/category/project-management/google-calendar/common-issues.md).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/project-management/google-calendar/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.