Skip to content
Nappai Documentation

Google Calendar Calendars

This component lets you work with your Google Calendar directly from the Nappai dashboard.
You can create new events, look up existing ones, change details, or remove them, all without leaving the platform.

How it Works

When you use this component, Nappai talks to the Google Calendar API.
It sends the information you provide (like the event title, description, or calendar ID) to Google, and Google returns the result.
Because the component is built on top of the Google Calendar API, you need a Google Calendar credential that gives Nappai permission to read and write your calendars.

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: Add a new event to a calendar.
  • Get: Retrieve information about one or more calendars or events.
  • Update: Change details of an existing event.
  • Delete: Remove an event from a 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.

Credential

Before you can use the component, you must set up a Google Calendar credential in Nappai’s credentials section.
After the credential is created, select it in the Credential field of this component.
The credential requires a Client Id, Client Secret, and a Google Calendar access scope.
You can find your API key in the Google Cloud Console.

Input Fields

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

  • Operation: Choose the action you want to perform (Create, Get, Update, Delete).

    • Visible in: Create, Get, Update, Delete

  • Calendar Id: Enter the ID of the calendar you want to work with. In the Get operation, if you leave this blank, all calendars will be returned.

    • Visible in: Get, Update, Delete

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

    • Visible in: Get, Update, Delete

  • Description: The description of the event.

    • Visible in: Create, Update

  • Input Type: Choose how you provide the calendar ID.

    • If Id is selected, the input will be the Id of the calendar.
    • If Selection is selected, the input will be a selection.
    • Visible in: Get, Update, Delete

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

    • Visible in: Create, Get, Update, Delete

  • Summary: The summary (title) 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. This name will be displayed to the agent when it selects tools to use.

    • Visible in: Create, Get, Update, Delete

  • Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.

    • Visible in: Create, Get, Update, Delete

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

    • Visible in: Create, Get, Update, Delete

Outputs

  • Data: The raw data returned from the Google Calendar API (e.g., event details, calendar list).
  • Tool: A tool representation that can be used by Nappai agents to perform the selected operation.

Usage Example

Creating an Event

  1. Set Operation to Create.
  2. In Calendar Id, enter the ID of the calendar where you want the event.
  3. Provide a Summary (e.g., “Team Meeting”) and a Description (e.g., “Discuss project milestones”).
  4. Optionally, enable Mapping Mode if you want to create multiple events from a list.
  5. Run the component. The Data output will contain the details of the newly created event.

Getting Calendars

  1. Set Operation to Get.
  2. Leave Calendar Id blank to retrieve all calendars, or enter a specific ID to get that calendar only.
  3. Run the component. The Data output will list the calendars or the requested calendar’s details.
  • Google Calendar Events – Manage individual events (create, update, delete) with more detailed event fields.
  • Google Calendar Calendar List – List all calendars in your Google account.

Tips and Best Practices

  • Use Mapping Mode when you need to process many events at once; it saves time and reduces API calls.
  • Give your Tool Name a clear, descriptive title so agents can easily identify it.
  • Keep your Credential up to date; if you change your Google Cloud project, update the credential in Nappai.
  • Test the component with a small number of events first to confirm your settings before scaling up.

Security Considerations

  • The Google Calendar credential is stored securely by Nappai; never share the Client Id or Client Secret in public places.
  • Use the least‑privilege scope needed for your workflow (e.g., only calendar read/write, not full Google account access).
  • Regularly review and rotate credentials to maintain security.