Skip to content
Nappai Documentation

Google Calendar Event

The Google Calendar Event component lets you create, read, update, or delete events in your Google Calendar directly from the Nappai dashboard. It works with your Google Calendar account and can even add a Google Meet link to an event.

How it Works

When you add this component to a workflow, it talks to the Google Calendar API.

  • It uses the Google Calendar credential you set up in Nappai to authenticate.
  • Depending on the operation you choose (Create, Get, Update, Delete), it sends the appropriate request to Google Calendar.
  • The component can also create a Google Meet link if you tick the “Create Meet” option.
  • All data you provide (dates, attendees, description, etc.) is sent in the request, and the response is returned as Data or as a Tool that an agent can use.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

  • Create: Adds a new event to your calendar.
  • Get: Retrieves one or more events from your calendar.
  • Update: Modifies an existing event.
  • Delete: Removes an event from your calendar.

To use the component, first select the operation you need in the “Operation” field.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

  • End: The end time of the event in YYYY-MM-DD HH-MM-SS AM/PM TZ format.

    • Visible in: Create, Update

  • Start: The start time of the event in YYYY-MM-DD HH-MM-SS AM/PM TZ format.

    • Visible in: Create, Update

  • Operation: Choose which action to perform.

    • Visible in: Create, Get, Update, Delete

  • Attendees: The attendees of the event.

    • Visible in: Create, Update

  • Calendar Id: The ID of the calendar. If left blank, the primary calendar is used.

    • Visible in: Create, Get

  • Calendar Selection: Pick a calendar from your Google Calendar list.

    • Visible in: Create, Get

  • Create Meet: Add a Google Meet link to the event.

    • Visible in: Create, Update

  • Description: The description of the event.

    • Visible in: Create, Update

  • Event ID: The ID of the event you want to get, update, or delete. If omitted in a Get operation, all events are returned.

    • Visible in: Get, Update, Delete

  • Input Type: Choose whether to provide the calendar ID directly or select it from a list.

    • Visible in: Create, Get

  • Location: The location of the event.

    • Visible in: Create, Update

  • Mapping Mode: Enable mapping mode to process multiple data records in batch.

    • Visible in: Create, Get, Update, Delete

  • Summary: The title or summary of the event.

    • Visible in: Create, Update

  • Tool Name: The name of the tool that will be used when this component is connected as a tool.

    • Visible in: Create, Get, Update, Delete

  • Tool Description: A detailed description of what this tool does.

    • Visible in: Create, Get, Update, Delete

  • Tools arguments metadata: Defines the arguments metadata for the tools.

    • Visible in: Create, Get, Update, Delete

Credential – This component requires a Google Calendar credential.

  1. First, set up a Google Calendar credential in the Nappai credentials section.
  2. Then, select that credential in the “Credential” field of this component.
    (The credential fields such as Client Id, Client Secret, and Google Calendar access are handled by Nappai and are not shown here.)

Outputs

  • Data – The raw data returned from the Google Calendar API (method: perfom_operation).
  • Tool – A tool representation that can be used by an agent (method: to_toolkit).

Usage Example

Creating an Event

  1. Drag the Google Calendar Event component onto the canvas.
  2. Set Operation to Create.
  3. Fill in Start and End with the desired dates and times.
  4. Enter a Summary and optional Description.
  5. If you want a Google Meet link, check Create Meet.
  6. Provide the Calendar Id or choose a calendar with Calendar Selection.
  7. Connect the Credential field to your Google Calendar credential.
  8. Run the workflow – the event will appear in your Google Calendar.

Getting Events

  1. Set Operation to Get.
  2. Optionally provide a Calendar Id or use Calendar Selection.
  3. Leave Event ID blank to retrieve all events, or specify an ID to get a single event.
  4. Run the workflow – the component returns the event data in the Data output.
  • Google Events Custom – The base component that provides common Google Calendar functionality.
  • Google Calendar Event – This component extends the base with specific operations and fields.

Tips and Best Practices

  • Use Mapping Mode when you need to process a list of events in a single workflow.
  • Keep the date/time format exactly as YYYY-MM-DD HH-MM-SS AM/PM TZ to avoid errors.
  • If you only need to read events, leave Event ID blank in the Get operation to fetch all events.
  • Store the Credential securely in Nappai; never expose client secrets in your workflow.

Security Considerations

  • The component uses OAuth credentials stored in Nappai; ensure only authorized users can access the credential.
  • Do not share the credential details in public or untrusted environments.
  • The component only accesses the calendars you grant it permission for, following Google’s OAuth scopes.