54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
# 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! |