Google Tasks - ollim-bot

ollim-bot provides full read/write access to a Google Tasks list. You can list, add, complete, update, and delete tasks through CLI commands, and the agent can present tasks in Discord embeds with action buttons for one-click completion or deletion. By default, ollim-bot targets your default task list (@default). Set the google_task_list runtime config key to point at a different list, or pass --list <id> to any command to override per-invocation.

Prerequisites

Google OAuth credentials configured (see Google integration setup)
Google account connected via /google-auth — the tasks scope is included by default

Setup

No additional setup is required beyond the shared Google OAuth flow. The tasks scope is included by default. Once you’ve completed the Google integration setup, Tasks is ready to use.

Usage

CLI
Agent

The ollim-bot tasks subcommand provides six operations.Every tasks subcommand accepts --list <id> to target a specific task list for that invocation. When omitted, the configured google_task_list is used.

List tasks

ollim-bot tasks list

Shows incomplete tasks from the configured task list. Each line displays the task ID, due date, status checkbox, and title:

  abc123  2026-03-01    [ ]  Buy groceries [+]
  def456  (no due)      [ ]  Call dentist

Tasks with notes display a [+] marker after the title.To include completed and hidden tasks:

ollim-bot tasks list --all

To list from a specific task list, pass --list:

ollim-bot tasks list --list MDc3NDk2NzQ3MTE0MTI2NjU5NzU6MDow

Show task details

ollim-bot tasks show <task_id>

Displays full details for a task — title, status, due date, notes, and ID:

title:     Buy groceries
status:    needs action
due:       2026-03-01
notes:     Milk, eggs, bread
id:        abc123

Add a task

ollim-bot tasks add "Buy groceries" --due 2026-03-01 --notes "Milk, eggs, bread"

Argument	Required	Description
`title` (positional)	Yes	Task title
`--due`	No	Due date in `YYYY-MM-DD` format
`--notes`	No	Task notes or description
`--list`	No	Task list ID — defaults to `google_task_list`

Due dates are stored as midnight UTC (YYYY-MM-DDT00:00:00.000Z).

Complete a task

ollim-bot tasks done <task_id>

Update a task

ollim-bot tasks update <task_id> --title "Updated title" --due 2026-03-15

At least one of --title, --due, or --notes must be provided.

Delete a task

ollim-bot tasks delete <task_id>

Permanently deletes the task from the configured task list.

The agent interacts with Google Tasks through two mechanisms.

Embed buttons

When the agent presents tasks in a Discord embed, it can attach action buttons:

Complete — marks the task as completed
Delete — permanently removes the task

Clicking a button shows a temporary confirmation only you can see. The agent also gets an update so it knows what you did. Buttons honor the configured google_task_list, and the agent can encode a specific list ID into the button action when a task lives in a non-default list.

CLI delegation

The agent can also run ollim-bot tasks subcommands directly for operations like listing all tasks, adding new ones, or updating existing entries. When a specific task list is relevant, the agent passes --list <id> — otherwise it uses the configured default.

Configuring the task list

The google_task_list runtime config key sets the default task list. Defaults to @default — Google’s alias for your primary task list. To target a different list, set google_task_list to its ID. Task list IDs are Google-generated strings; you can get them from the Google Tasks API tasklists.list endpoint. See the configuration reference for how to inspect and change runtime config keys.

Troubleshooting

Tasks commands return an auth error

Your OAuth token may have expired or been revoked. The bot detects revocations automatically and prompts you to reconnect — run /google-auth to re-authenticate.

How do I find a task ID?

Task IDs are displayed as the first column in ollim-bot tasks list output. When using embed buttons, the agent handles IDs automatically.

A command targets the wrong task list

Commands use google_task_list by default (alias @default). To check which list you’ve configured, run /config with no parameters. To target a different list for a single command, pass --list <id>.

Due dates show the wrong day

Due dates are stored as midnight UTC. The Google Tasks API and CLI both use YYYY-MM-DD format. If your local timezone is ahead of UTC, a task due “today” may display as yesterday in some Google interfaces.

Next steps

Google Calendar

Manage calendar events 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.

​Prerequisites

​Setup

​Usage

​List tasks

​Show task details

​Add a task

​Complete a task

​Update a task

​Delete a task

​Embed buttons

​CLI delegation

​Configuring the task list

​Troubleshooting

​Next steps