MCP tools: Scheduled tasks

Last updated About 2 hours ago

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.

ParameterTypeDescription
titlestring (required)Short title
action_typeenum reminder | ai_task (required)What fires: a notification or an autonomous AI run
atstring (ISO)One-off: the fire time. Recurring: the anchor (start + time of day)
rrulestringiCal RRULE, e.g. FREQ=WEEKLY;BYDAY=MO,WE,FR. Omit for a one-off task
timezonestringIANA timezone, e.g. Europe/Berlin
max_runsinteger > 0Stop after this many runs (recurring only)

Provide either at or rrule.

reminder only:

ParameterTypeDescription
messagestring (required)The notification text
recipientsstring[]User IDs (default: yourself)
list / list_itemstringRelated list/item for the deep link
post_to_item_chatbooleanAdditionally post permanently into the item's chat (only with list_item)
create_eventobjectAlso create a Liza calendar event: title, start, end, duration_minutes (default 30), all_day, location, description, calendar

ai_task only:

ParameterTypeDescription
promptstring (required)What the AI should do
providerstringAI provider (default: x-liza-provider, or the last one used for this scope)
modelstringModel override
scope / scope_idstringScope type (e.g. item) and UUID
scope_keystringIdentifies the AI conversation. If omitted, the current conversation is used (header x-liza-conversation)
json

list_scheduled_tasks ​

Your scheduled tasks, soonest next run first. read · follower

ParameterTypeDefaultDescription
statusenum active | paused | done | error | canceled | allactiveFilter
limitnumber50Max 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

ParameterTypeDescription
taskIdstring (required)UUID or SID
titlestringNew title
atstring (ISO)New time / anchor
rrulestringNew RRULE — an empty string makes the task one-off
timezonestringNew timezone
max_runsinteger | nullSet/remove the limit
message / recipientsstring / string[]reminder only
prompt / provider / modelstringai_task only

Given fields are merged into the existing task.

pause_scheduled_task ​

Pause or resume. write · user

ParameterTypeDefaultDescription
taskIdstring (required)–UUID or SID
resumebooleanfalsetrue = reactivate a paused task

cancel_scheduled_task ​

Cancel permanently — the task will never fire again. destructive · user

ParameterTypeDescription
taskIdstring (required)UUID or SID