Skip to main content
ollim-bot integrates with three Google services through a shared OAuth2 flow. A single set of credentials handles authentication for Google Tasks, Google Calendar, and Gmail — no per-service setup needed. All three services are available as both CLI subcommands and agent capabilities. The agent uses CLI commands (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: Run /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

Find what you need

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.