Google Calendar

Use Google Calendar with Agno agents.

Enable Agno agents the “executive assistance” capability to move beyond just reading emails or chat to actively managing your time, coordinating with teams, and resolving scheduling conflicts autonomously with Google Calendar.

• Availability intelligence
• Dynamic scheduling
• Contextual invitations
• Timezone and conflict management

Prerequisites

1. Enable Google Calender API - Go To https://console.cloud.google.com/apis/enableflow?apiid=calendar-json.googleapis.com

2. Select Project and enable the API access (Reference : https://developers.google.com/calendar/api/quickstart/python)

3. (Click for details)

   Get the Google OAuth Credentials

   1. Enable Google Calender API

      • Go To https://console.cloud.google.com/apis/enableflow?apiid=calendar-json.googleapis.com
      • Select Project and Enable The API

   2. Go To API & Service -> OAuth Consent Screen

   3. Select User Type

      • If you are Google Workspace User select Internal
      • Else Select External

   4. Fill in the app details (App name, logo, support email, etc.).

   5. Select Scope

      • Click on Add or Remove Scope
      • Search for Google Calender API (Make Sure you’ve enabled Google calender API otherwise scopes wont be visible)
      • Select Scopes Accordingly
      • From the dropdown check on /auth/calendar scope
      • Save and Continue

   6. Adding Test User

      • Click Add Users and enter the email addresses of the users you want to allow during testing.
      • NOTE : Only these users can access the app’s OAuth functionality when the app is in “Testing” mode. If anyone else tries to authenticate, they’ll see an error like: “Error 403: access_denied.”
      • To make the app available to all users, you’ll need to move the app’s status to “In Production.”.Before doing so, ensure the app is fully verified by Google if it uses sensitive or restricted scopes.
      • Click on Go back to Dashboard

   7. Generate OAuth 2.0 Client ID

      • Go To Credentials
      • Click on Create Credentials -> OAuth Client ID
      • Select Application Type as Desktop app
      • Download JSON

   8. Using Google Calender Tool pass the path of downloaded credentials as credentials_path to Google Calender tool

from agno.agent import Agent
from agno.tools.googlecalendar import GoogleCalendarTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------


agent = Agent(
    tools=[
        GoogleCalendarTools(
            # credentials_path="credentials.json",  # Path to your downloaded OAuth credentials
            # token_path="token.json",  # Path to your downloaded OAuth credentials
            oauth_port=8080,  # port used for oauth authentication
            allow_update=True,
        )
    ],
    instructions=[
        """
    You are a scheduling assistant.
    You should help users to perform these actions in their Google calendar:
        - get their scheduled events from a certain date and time
        - create events based on provided details
        - update existing events
        - delete events
        - find available time slots for scheduling
    """
    ],
    add_datetime_to_context=True,
)

# Example 1: List calendar events

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    agent.print_response("Give me the list of tomorrow's events", markdown=True)

    # Example 2: Create an event
    # agent.print_response(
    #     "create an event tomorrow from 9am to 10am, make the title as 'Team Meeting' and description as 'Weekly team sync'",
    #     markdown=True,
    # )

    # Example 3: Find available time slots
    # agent.print_response(
    #     "Find available 1-hour time slots for tomorrow between 9 AM and 5 PM",
    #     markdown=True,
    # )

    # Example 4: List available calendars
    # agent.print_response(
    #     "List all my calendars",
    #     markdown=True,
    # )

    # Example 5: Update an event
    # agent.print_response(
    #     "update the 'Team Meeting' event to run from 5pm to 7pm and change description to 'Extended team sync'",
    #     markdown=True,
    # )

    # Example 6: Delete an event
    # agent.print_response("delete the 'Team Meeting' event", markdown=True)

    # # Example 7: Find available time slots for a specific calendar
    # agent.print_response(
    #     "Find available 1-hour time slots for this week between 9 AM and 5 PM in the Appointments calendar",
    #     markdown=True,
    # )

    # Example 9: Find available slots using locale-based working hours
    # agent.print_response(
    #     "Find available 60-minute slots for the next 3 days", markdown=True
    # )

Run the Example

# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python googlecalendar_tools.py

For details, see Google Calendar cookbook.