Koala

Appends the supplied short reminder to the connected user's Today notes widget, with an optional colour. Existing notes are preserved. Does not create an action or task, and does not automatically deduplicate note text.

add_note

Adds tasks to an existing action in the connected account, preserving that parent action. New tasks are appended or inserted after afterTaskId. Koala fills out task details, applies the user's time multiplier unless exact estimatedMinutes are supplied, schedules the new work and refreshes the plan.

add_tasks_to_action

Saves a previously reviewed temporary draft to the connected account using its draftId and any supplied edits. Applies the deadline buffer and time multiplier, creates the action and tasks, schedules work and refreshes the plan. Supplied task, note or stakeholder arrays replace the drafted arrays; omitted arrays retain the draft values. A draft made with captureMode=task saves exactly one task pinned to local today; changing the parent Action deadline does not move that task.

commit_action

Marks the specified existing tasks complete in the connected account and refreshes the plan. Each task requires its actual local completedTime in HH:MM; completedDate defaults to today in the user's timezone. actualMinutes records actual effort when supplied. Does not create replacement actions or tasks.

complete_tasks

Creates a new action and tasks in the connected account in one step, without a temporary review stage. Supplied tasks are used as the breakdown; omitted tasks are generated by Koala. Applies the deadline buffer and time multiplier, schedules the work and refreshes the plan. Always creates a new action rather than editing an existing one.

create_action_with_tasks

Creates a reviewable temporary action draft from a goal and the task-specific context supplied. Koala generates tasks sized to the connected user's preferences and flags possible duplicates. For an individual task requested for today, set captureMode=task: this drafts exactly one task, pinned to local today on confirmation. Draft unrelated today tasks separately; keep larger outcomes in action mode. The draft is stored temporarily for review and later saving; no live action or task is added or scheduled at this stage.

draft_action_from_context

Lists the connected user's actions and lightweight tasks, including IDs and editable action context. Archived actions are included only when includeArchived is true. Read-only. Access is authorized only for practical work planning. Retrieval for diagnosis, screening, assessment of medical signs or likelihood, and clinical-pattern interpretation is outside this tool's authorized scope.

list_actions

Reads the connected user's current Today notes, including note text and colours where present. Read-only. Access is authorized only for practical work planning. Retrieval for diagnosis, screening, assessment of medical signs or likelihood, and clinical-pattern interpretation is outside this tool's authorized scope.

list_notes

Returns the connected user's tasks scheduled for today and their working details. Read-only; does not reschedule work. Access is authorized only for practical work planning. Retrieval for diagnosis, screening, assessment of medical signs or likelihood, and clinical-pattern interpretation is outside this tool's authorized scope.

list_todays_tasks

Returns the connected user's Monday-to-Sunday schedule, tasks grouped by day, daily and weekly capacity, and active-task flags. includeCompleted includes finished tasks; includeBacklog includes unscheduled tasks. Read-only; does not reschedule work. Access is authorized only for practical work planning. Retrieval for diagnosis, screening, assessment of medical signs or likelihood, and clinical-pattern interpretation is outside this tool's authorized scope.

list_week_tasks