> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar Event Creator

> Creates detailed calendar events from natural language descriptions.

```python event_creator.py theme={null}
"""
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,
    )
```

## 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 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 `event_creator.py`, then run:

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

Full source: [cookbook/91\_tools/google/calendar/event\_creator.py](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/google/calendar/event_creator.py)