📅
CALENDAR
Natural language → Google Calendar → WhatsApp reminders
Neo types a plain-English reminder; Zion parses date, time, and title with Groq or Gemini, writes to Google Calendar, confirms on WhatsApp, then calendar_reminder.py polls every 10 minutes and sends 24h / 2h / 1h heads-ups.
A Real Conversation
Create in chat — reminders fire automatically from the calendar service
@zion remind me dentist
tomorrow 3pm
11:20 AM
[Zion] ✅ Event Created!
━━━━━━━━━━━━━━━━━━━━━━
📅 Dentist
📆 Tomorrow, 3:00 PM
⏰ Reminder: 1 hour before
Added to Google Calendar
11:20 AM ✓✓
[Zion] 📅 Reminder:
Dentist in 1 hour!
(Today 3:00 PM)
2:00 PM ✓✓
Also: @zion what's today? → shows all events
🔍 click to read full brief
NEO
📱 WhatsApp — same thread
ZION
routes @zion remind
calendar intent
NL command
GROQ / GEMINI
parse title + date/time
timezone-aware JSON
structured event draft
GOOGLE CALENDAR API
OAuth2 — create event
eventId stored in DB
calendar_reminders.db
WhatsApp confirm
[Zion] ✅ Created…
Bridge /api/send
instant confirmation
calendar_reminder.py
poll every 10 min
24h / 2h / 1h windows
zion-calendar.service
later: scheduled pings
Key files: calendar_create.py · calendar_reminder.py
Capability Map
Calendar construct — center hub + four domains
📅
CALENDAR
CREATE
natural language → event
Groq / Gemini parser
Google Calendar API write
title + datetime + tz
REMINDERS
24h, 2h, 1h before
poll every 10 minutes
zion-calendar.service
calendar_reminder.py
WhatsApp nudge text
SYNC
Google Calendar OAuth2
calendar_reminders.db
event IDs + fire times
durable reminder queue
COMMANDS
@zion remind me …
@zion calendar
@zion today
list / query / cancel flows
Tech Stack
Runtime Python 3 — zion.service + zion-calendar.service
Parser Groq OpenAI GPT-OSS-120B / Gemini Flash — NL → structured event
Calendar Google Calendar API — OAuth2, create + list
Reminders calendar_reminder.py — 10 min poll, 24h/2h/1h tiers
Storage calendar_reminders.db — SQLite on VM
Delivery WhatsApp Bridge POST /api/send
Key Files calendar_create.py, calendar_reminder.py