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 alice@company.com and bob@company.com. "
        "Add a Google Meet link. In the description, note that we'll be "
        "reviewing the Q1 roadmap and discussing launch timelines.",
        stream=True,
    )

Replace the attendee placeholders with addresses you intend to invite and use an IANA timezone such as America/New_York instead of ambiguous EST. The actual tool argument is add_google_meet_link=True. Attendee email notifications default off; request notify_attendees=True when invitations should be emailed. This run creates an event in the authenticated user's calendar.

Run the Example

Set up your virtual environment

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

Install dependencies

uv pip install -U agno google-api-python-client google-auth google-auth-httplib2 google-auth-oauthlib openai

Configure Google OAuth

Enable the Google API used by this example, configure the consent screen, and create a Desktop OAuth client in your Cloud project. Export its GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_PROJECT_ID, or place the downloaded client JSON at credentials.json in the directory where you run Python. Google's Python quickstart shows the Desktop client setup.

The first tool call opens a browser for consent and caches credentials in token.json. Use a separate token_path when switching accounts. Passing an Agno user_id does not switch the authenticated Google account.

Export environment variables

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"

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