Docs
Official Tools
Function Tools
Google Calendar

Google Calender

The Google Calendar Tool enables you to retrieve or create events on Google Calendar.

Setup

Get Google Workspace OAuth Credentials

Follow this guide to create a desktop app and download your oauth secret file: https://developers.google.com/workspace/guides/create-credentials#desktop-app (opens in a new tab)

Authorization

npi auth google calendar --secret-file <path-to-secret-file>

Usage

npi app gcal "Is example@example.com free next Monday at 3pm?"

Supported Features

Event Retrieval

  • Description: Fetch events from a specific calendar.
  • In-Context Parameters1:
    • Calendar ID, which is usually the email of the user. The app will prompt you for it if omitted.
    • (Optional) Time frame specification for event searches.

Examples

  1. Check Availability

    # Assume "example@example.com" is the calendar ID to check
npi app gcal "Is example@example.com free next Monday at 3pm?"

Event Creation

  • Description: Add a new event to your primary calendar.
  • In-Context Parameters:
    • Details of the event.
    • Specific timing for the event.
    • (Optional, Inferred) Event title.

Examples

  1. Scheduling a Meeting

    npi app gcal "Schedule a meeting to invite a@a.com, b@b.com to discuss the project next Monday at 3 PM."
Didn't find the feature you were looking for? Feel free to submit an issue or PR!
Footnotes

Footnotes

  1. In-Context Parameters refer to the special information that you may specify in the instructions. Parameters marked as Inferred could be deduced from the context without needing explicit mention. ↩

GmailDiscord