Calendar Event Creator

Creates detailed calendar events from natural language descriptions.

event_creator.py

"""
Calendar Event Creator
======================
Creates detailed calendar events from natural language descriptions.

The agent parses complex event requests and uses create_event with all available
parameters: title, description, location, attendees, timezone, and Google Meet links.

Key concepts:
- create_event: full event creation with attendees and conferencing
- update_event: modify existing events after creation
- add_datetime_to_context: agent knows "now" for relative date references

Setup:
1. Create OAuth credentials at https://console.cloud.google.com (enable Calendar API)
2. Export GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_PROJECT_ID env vars
3. pip install openai google-api-python-client google-auth-httplib2 google-auth-oauthlib
4. First run opens browser for OAuth consent, saves token.json for reuse
"""

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.google.calendar import GoogleCalendarTools

agent = Agent(
    name="Event Creator",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[GoogleCalendarTools()],
    instructions=[
        "When creating events, always include a clear title and appropriate timezone.",
        "For meetings with others, add attendees and a Google Meet link.",
        "Use the description field for agenda items or context.",
        "After creating an event, confirm the details back to the user.",
    ],
    add_datetime_to_context=True,
    markdown=True,
)


if __name__ == "__main__":
    agent.print_response(
        "Create a 1-hour product review meeting next Tuesday at 2pm EST "
        "in Conference Room B with [e-mail] and [e-mail]. "
        "Add a Google Meet link. In the description, note that we'll be "
        "reviewing the Q1 roadmap and discussing launch timelines.",
        stream=True,
    )

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno google-api-python-client google-auth google-auth-httplib2 google-auth-oauthlib openai
   
3. Export environment variables

   Mac/Linux

   export GOOGLE_CLIENT_ID="your_google_client_id_here"
   export GOOGLE_CLIENT_SECRET="your_google_client_secret_here"
   export GOOGLE_PROJECT_ID="your_google_project_id_here"
   export OPENAI_API_KEY="your_openai_api_key_here"
   

   $Env:GOOGLE_CLIENT_ID="your_google_client_id_here"
   $Env:GOOGLE_CLIENT_SECRET="your_google_client_secret_here"
   $Env:GOOGLE_PROJECT_ID="your_google_project_id_here"
   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   
4. Run the example

   Save the code above as event_creator.py, then run:

   python event_creator.py
   

Full source: cookbook/91_tools/google/calendar/event_creator.py