Skip to content
Nappai Documentation

GoogleCalendarToolkit

⚠️ DEPRECATION WARNING

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

The GoogleCalendarToolkit component lets you connect your Nappai dashboard to Google Calendar. With it you can create, update, delete, and search for events directly from your workflows.

How it Works

When you add the component, you first supply a Credential that contains your Google Cloud Project’s Client ID, Client Secret, and the Google Calendar access setting. The component then uses the OAuth 2.0 token string you provide to build a Credentials object. This object authenticates with Google’s Calendar API. The component calls helper functions to create a service resource and returns a GoogleCalendarToolkit object. That toolkit bundles a set of tools (e.g., create event, update event, delete event, list events) that you can use in later components of your workflow.

Inputs

This component requires a Google Calendar credential.

  1. Configure the credential in the Nappai credentials section.
  2. Select the credential in the component’s Credential field.

The following input fields are available to configure the component:

Input Fields

  • Scopes: Scopes for the Google Calendar API.
    Example: https://www.googleapis.com/auth/calendar or https://www.googleapis.com/auth/calendar.readonly.

  • Token String: JSON string containing OAuth 2.0 access token information for service account access.
    Example:

    {
      "client_id": "your-client-id",
      "client_secret": "your-client-secret",
      "refresh_token": "your-refresh-token",
      "access_token": "your-access-token",
      "expiry": "2025-12-31T23:59:59Z"
    }

Outputs

  • BaseToolkit: A BaseToolkit object that contains the tools for interacting with Google Calendar.
    You can pass this toolkit to other components that perform actions such as creating or searching events.

Usage Example

  1. Add the GoogleCalendarToolkit component to your workflow.
  2. Select the Google Calendar credential you created earlier.
  3. Set Scopes to https://www.googleapis.com/auth/calendar.
  4. Paste your Token String into the field.
  5. The component outputs a BaseToolkit.
  6. Connect the BaseToolkit output to a Calendar Action component (or any other component that accepts a toolkit) to create, update, delete, or query events.
  • Google Calendar Toolkit (new) – The updated component that replaces this legacy version.
  • Google Calendar API Integration – A lower‑level component for direct API calls.

Tips and Best Practices

  • Use the least privileged scope needed for your workflow (e.g., calendar.readonly if you only need to read events).
  • Keep your Token String secure; treat it like a password.
  • Refresh your token regularly or use a service account with a long‑lived refresh token.
  • Test the toolkit in a sandbox environment before deploying to production.

Security Considerations

  • The Token String contains sensitive OAuth credentials. Store it in a secure vault or use Nappai’s credential management.
  • Never expose the token string in logs or UI elements that are accessible to unauthorized users.
  • Ensure that the Google Calendar credential has the minimal permissions required for your use case.