> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Calendar

> List, create, update and delete Google Calendar events and find free slots via OAuth with GoogleCalendarTools.

Enable Agno agents to list, create, update, and delete Google Calendar events and find free time slots.

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

## Prerequisites

1. Enable Google Calendar API - Go To [https://console.cloud.google.com/apis/enableflow?apiid=calendar-json.googleapis.com](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](https://developers.google.com/calendar/api/quickstart/python))
3. <AccordionGroup>
     *(Click for details)*

     <Accordion title="Get the Google OAuth Credentials">
       1. Enable Google Calendar API

          * Go To [https://console.cloud.google.com/apis/enableflow?apiid=calendar-json.googleapis.com](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 Calendar API (Make sure you've enabled Google Calendar API. Otherwise, the scopes will not 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 Calendar Tool pass the path of downloaded credentials as  credentials\_path to Google Calendar tool
     </Accordion>
   </AccordionGroup>

```python theme={null}
from agno.agent import Agent
from agno.tools.google.calendar 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

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno google-api-python-client google-auth-httplib2 google-auth-oauthlib openai
    ```
  </Step>

  <Step title="Export your OpenAI API key">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export OPENAI_API_KEY="your_openai_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Run the example">
    Save the code above as `googlecalendar_tools.py`, then run:

    ```bash theme={null}
    python googlecalendar_tools.py
    ```
  </Step>
</Steps>

Full source: [cookbook/91\_tools/googlecalendar\_tools.py](https://github.com/agno-agi/agno/blob/v2.7.4/cookbook/91_tools/googlecalendar_tools.py)