# Calendar Channel - Discord #1474636036905631867

A dedicated calendar space where you can interact with Home Assistant's calendar using natural language.

## Quick Commands

### View Events
- **"What do I have today?"** → Shows today's schedule
- **"Show upcoming events"** → Lists events for the next 7 days
- **"This week's events"** → Shows this week's schedule

### Add Events
- **"Add [event name] on [YYYY-MM-DD] at [time]"**
  - Example: `Add grocery run on 2026-02-22 at 3pm`
  - Example: `Schedule dentist for 2026-02-25 at 10:00`
  - Example: `New event: Team meeting 2026-02-24 14:00`

### Examples

```
Add grocery run on 2026-02-22 at 3pm
→ ✅ Added: grocery run on 2026-02-22 at 3pm

What do I have today?
→ • Dentist at 10:00
• Team meeting at 2:00

Show upcoming events
→ • Team meeting - 2026-02-24 at 14:00
• Grocery run - 2026-02-22 at 15:00
• ...
```

## Files

- **Calendar Agent:** `agents/calendar-agent.py`
- **HA Calendar API:** `api/ha_calendar.py`

## Technical Details

- Connected to **Home Assistant** at `http://192.168.0.39:8123`
- Calendar entity: `calendar.appointments`
- Uses Home Assistant's Calendar API via REST
- Events added here sync to HA calendar immediately

## Supported Date/Time Formats

| Format | Example |
|--------|---------|
| ISO | `2026-02-22 15:00` |
| Natural | `2026-02-22 3pm` |
| Date only | `2026-02-22` (defaults to 9 AM) |

Commands are case-insensitive and flexible—just speak naturally!