ollim-bot tasks,
ollim-bot cal) and embed buttons to interact with Tasks and Calendar,
and a dedicated subagent for Gmail.
Available services
Google Tasks
Full task management — list, add, complete, update, and delete tasks via CLI or agent.
Google Calendar
Event management — list, show, add, update, and delete calendar events via CLI or agent.
Gmail
Read-only email access — list and read messages via CLI or the gmail-reader subagent.
How it works
All Google services share a single OAuth2 credential. One consent flow grants access to all three services:| Service | Access level |
|---|---|
| Google Tasks | Read/write |
| Google Calendar | Read/write |
| Gmail | Read-only |
/google-auth to connect
your Google account. The command supports both a browser-based flow and a
paste-based flow for headless servers. After granting access, the token is
cached and refreshed automatically — you only need to consent once.
If your token is revoked (password change, manual revocation), the bot
detects it automatically and prompts you to reconnect with /google-auth.
If a code update adds new scopes, delete
~/.ollim-bot/state/token.json and run /google-auth to re-consent.Credential files
| File | Path | Purpose |
|---|---|---|
| OAuth client credentials | ~/.ollim-bot/state/credentials.json | Downloaded from Google Cloud Console |
| Cached token | ~/.ollim-bot/state/token.json | Auto-generated after /google-auth |
Find what you need
| I want to… | Go to |
|---|---|
| Connect my Google account for the first time | Set up Google integration |
| Manage tasks with the bot or CLI | Google Tasks |
| View and manage calendar events | Google Calendar |
| Read emails via the gmail-reader subagent | Gmail |
| Trigger the bot from external services | Webhooks |
Next steps
Set up Google integration
Step-by-step guide to connecting Google Tasks, Calendar, and Gmail.
Webhooks
Trigger background forks from external services via HTTP.