Google Calendar Integration

What the Integration Does

The Google Calendar integration allows seamless interaction with your Google Calendar, enabling your agent to list events and create new events within the calendar.

Short Description

This integration provides an interface to both list upcoming events and create new events on your Google Calendar directly through the Fluo Platform's interface.

Example Scenarios

  • List events to keep track of upcoming schedules or appointments.
  • Create events to schedule new meetings, reminders, or tasks directly from your interface or app.

Capabilities

What the Integration Enables

  • List Events: Retrieve a list of upcoming events.
  • Create Event: Schedule new events with specific details such as title, description, and attendees.

Input/Output Schemas for Each Capability

  • List Events
    • Input: limit (Optional, default 10), date_from (Optional, ISO date format, default today)
    • Output: JSON object with event details or error message.
  • Create Event
    • Input:
      • start_datetime (Required, in ISO format)
      • end_datetime (Required, in ISO format)
      • title (Optional)
      • description (Optional)
      • location (Optional)
      • timezone (Optional)
      • attendees (Optional, list of emails)
    • Output: JSON object with created event details or error message.

Limitations

  • Rate limits may apply based on Google Calendar API usage.
  • Access is limited to the primary calendar.

Setup & Configuration

Prerequisites

  • Google account
  • Access to Google Calendar

Authentication

  1. Obtain OAuth 2.0 Client ID:
  2. Manage access tokens:
    • Token JSON file stores access and refresh tokens automatically.

Step-by-Step Guide

  1. Credential Setup
    • Download and place your credentials.json file in your working directory.
  2. Run Application
    • Ensure authentication by running the app and following authentication prompts to generate a token.json file.

Testing Connection

Run a simple list or create event command to verify that the integration setup is working correctly.

How to Use in Agents

Example prompts or configurations

  • Use methods list_events and create_event as configured in your agent.

Code/Configuration Snippet

  • Configure paths for credentials.json and token.json, then initialize this tool in your agent definition.

Best Practices

  • Schedule events based on time zone settings for accuracy.
  • Regularly refresh tokens to maintain access.

Reference Section