Skip to content
Nappai Documentation

Google Calendar Loader

⚠️ DEPRECATION WARNING

This component is deprecated and will be removed in a future version of Nappai.
Please migrate to the recommended alternative components.

Google Calendar Loader is a legacy component that lets you pull events from a Google Calendar into your Nappai workflow.
It connects to the Google Calendar API, fetches a set of events based on a date range and optional query, and returns the event data so you can use it in downstream steps.

How it Works

When you add the component to a flow, it first uses the Google Calendar credential you selected to obtain an access token.
With that token, it creates a GoogleCalendarManager instance and calls search_unique_events_in_time_range.
You can specify:

  • Calendar – the calendar you want to read from.
  • Min Range and Max Range – the start and end of the time window (in YYYY-MM-DD HH:MM:SS AM/PM TZ format).
  • Query – a text filter that narrows the events returned.
  • Events to read – how many events to fetch (default 10).

The component converts the date strings to ISO‑8601 format, sends the request, and returns the events as a list of Data objects in the Events Content output.

Inputs

  • Min Range: The start time of the range in YYYY-MM-DD HH:MM:SS AM/PM TZ format.
  • Calendar: The summary of the calendar to read events from.
  • Max Range: The end time of the range in YYYY-MM-DD HH:MM:SS AM/PM TZ format.
  • Events to read: Number of events to read.
  • Query: Query to filter events.

Credential
This component requires a Google Calendar credential.

  1. Create a Google Calendar credential in the Nappai credentials section.
  2. In the component, select that credential in the Credential field.
    The credential must contain a Client ID, Client Secret, and the appropriate Google Calendar scopes.

Outputs

  • Events Content: A list of Data objects, each representing a calendar event.
    Use this output to feed into other components, such as data processors or notification senders.

Usage Example

  1. Add the component to your flow.
  2. Select the Google Calendar credential you created earlier.
  3. Choose a calendar from the dropdown.
  4. Set Min Range to 2024-01-01 09:00:00 AM UTC and Max Range to 2024-01-31 05:00:00 PM UTC.
  5. Optionally, enter a Query like meeting to only pull events that contain the word “meeting”.
  6. Set Events to read to 20.
  7. Connect the Events Content output to the next component (e.g., a table display or a notification step).

The component will return the 20 most recent events that match the criteria, ready for you to use in your workflow.

  • Google Calendar Manager – The modern replacement for this legacy loader.
    It offers the same functionality with a cleaner interface and better support for pagination and advanced filtering.

Tips and Best Practices

  • Use the correct date format (YYYY-MM-DD HH:MM:SS AM/PM TZ) to avoid conversion errors.
  • Limit the number of events you request to keep response times short.
  • Use a specific query to reduce the amount of data you need to process downstream.
  • Refresh the credential if you see authentication errors; the token may have expired.

Security Considerations

  • Keep your Google Calendar credential secure; it contains OAuth tokens that grant access to your calendars.
  • Do not expose the credential in public flows or share the flow with users who should not have calendar access.
  • Use the built‑in credential management in Nappai to control who can view or edit the credential.