Prerequisites
- Google account connected (see Google integration setup)
- Authenticated via
/google-auth
Setup
No additional setup is required. Once you’ve completed the Google integration setup, Calendar is ready to use.Usage
- CLI
- Agent
The Shows events for the current day. Each line displays the event ID, date, time range,
and title:Shows events for the next 7 days by default. Use
Displays detailed information including title, time, location, description,
link, attendees (by email), status, and event ID.
Times without a timezone are treated as the configured timezone (At least one of Permanently deletes the event from your primary calendar.
ollim-bot cal subcommand provides six operations.List today’s events
List upcoming events
--days to change the window:| Argument | Required | Default | Description |
|---|---|---|---|
--days | No | 7 | Number of days to look ahead |
Show event details
Add an event
| Argument | Required | Description |
|---|---|---|
summary (positional) | Yes | Event title |
--start | Yes | Start time in YYYY-MM-DDTHH:MM format |
--end | Yes | End time in YYYY-MM-DDTHH:MM format |
--description | No | Event description |
OLLIM_TIMEZONE).Update an event
--summary, --start, --end, or --description must be provided.Delete an event
All operations use your primary Google Calendar. ollim-bot does
not support secondary calendars or calendar selection.
Developer reference: API helpers
Developer reference: API helpers
One function is exported from
This is called via
google/calendar.py for use by the button handler in views.py:| Function | Signature | Returns |
|---|---|---|
delete_event | delete_event(event_id: str) -> str | Event summary |
asyncio.to_thread in the button handler to avoid blocking the event loop.Troubleshooting
Calendar commands return an auth error
Calendar commands return an auth error
Your Google connection may have expired or been revoked. The bot
detects this automatically and prompts you to reconnect — run
/google-auth to re-authenticate.How do I find an event ID?
How do I find an event ID?
Event IDs are displayed as the first column in
ollim-bot cal today and
ollim-bot cal upcoming output. When using embed buttons, the agent
handles this automatically.Times show in the wrong timezone
Times show in the wrong timezone
All times are handled in the configured timezone (
OLLIM_TIMEZONE,
defaults to auto-detected system timezone with a UTC fallback). Times
you enter without a timezone are assumed to be in this timezone.Next steps
Google Tasks
Manage your task list through similar CLI and agent interactions.
Google integration
Shared OAuth setup and all available Google services.
Embeds & buttons
How the agent builds Discord embeds with action buttons.
CLI reference
Full reference for all ollim-bot CLI subcommands.