MCP tools: Scheduled tasks
Time-triggered reminders and autonomous AI runs. Functionally the same as the Schedule area in the client (see guide).
schedule_task
Schedules a task – one-off or recurring. write · user
The only scheduler for Liza: it alone is wired into the calendar, items, notifications and autonomous AI runs.
| Parameter | Type | Description |
|---|---|---|
title | string (required) | Short title |
action_type | enum reminder | ai_task (required) | What fires: a notification or an autonomous AI run |
at | string (ISO) | One-off: the fire time. Recurring: the anchor (start + time of day) |
rrule | string | iCal RRULE, e.g. FREQ=WEEKLY;BYDAY=MO,WE,FR. Omit for a one-off task |
timezone | string | IANA timezone, e.g. Europe/Berlin |
max_runs | integer > 0 | Stop after this many runs (recurring only) |
Provide either at or rrule.
reminder only:
| Parameter | Type | Description |
|---|---|---|
message | string (required) | The notification text |
recipients | string[] | User IDs (default: yourself) |
list / list_item | string | Related list/item for the deep link |
post_to_item_chat | boolean | Additionally post permanently into the item's chat (only with list_item) |
create_event | object | Also create a Liza calendar event: title, start, end, duration_minutes (default 30), all_day, location, description, calendar |
ai_task only:
| Parameter | Type | Description |
|---|---|---|
prompt | string (required) | What the AI should do |
provider | string | AI provider (default: x-liza-provider, or the last one used for this scope) |
model | string | Model override |
scope / scope_id | string | Scope type (e.g. item) and UUID |
scope_key | string | Identifies the AI conversation. If omitted, the current conversation is used (header x-liza-conversation) |
{"name":"schedule_task",
"arguments":{"title":"Weekly report","action_type":"reminder",
"rrule":"FREQ=WEEKLY;BYDAY=MO","at":"2026-09-01T07:00:00Z",
"message":"Write the weekly report",
"create_event":{"duration_minutes":30}}}list_scheduled_tasks
Your scheduled tasks, soonest next run first. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
status | enum active | paused | done | error | canceled | all | active | Filter |
limit | number | 50 | Max results |
Per task: id, sid, title, action_type, schedule_kind (once/rrule), run_at, rrule, timezone, next_run, last_run, status, run_count, max_runs, payload, last_error.
update_scheduled_task
Rename, reschedule or change effect fields. write · user
| Parameter | Type | Description |
|---|---|---|
taskId | string (required) | UUID or SID |
title | string | New title |
at | string (ISO) | New time / anchor |
rrule | string | New RRULE — an empty string makes the task one-off |
timezone | string | New timezone |
max_runs | integer | null | Set/remove the limit |
message / recipients | string / string[] | reminder only |
prompt / provider / model | string | ai_task only |
Given fields are merged into the existing task.
pause_scheduled_task
Pause or resume. write · user
| Parameter | Type | Default | Description |
|---|---|---|---|
taskId | string (required) | – | UUID or SID |
resume | boolean | false | true = reactivate a paused task |
cancel_scheduled_task
Cancel permanently — the task will never fire again. destructive · user
| Parameter | Type | Description |
|---|---|---|
taskId | string (required) | UUID or SID |