Create a task
create_taskCreate a task. A "schedule" task needs exactly one of dow, cron or every_days. To put a task in a loop, create it with task_type "loop", then call enqueue_task.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "create_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dow | No | Days of the week as a bitmask: Monday=1, Tuesday=2, Wednesday=4, Thursday=8, Friday=16, Saturday=32, Sunday=64. 127 = every day, 31 = weekdays. 0 = none (use with cron or every_days). | |
| cron | No | Cron schedule, 5 fields; only the date fields (day of month, month, weekday) matter: minute and hour are ignored, so write them as "0 0" (e.g. "0 0 * * 1" = Mondays). Alternative to dow and every_days (one schedule system at a time). Do not use "*/N" in the day field for "every N days": it restarts each month; use every_days. | |
| name | Yes | Task name. | |
| every | No | Subtasks: armed every N runs of the parent. | |
| end_date | No | Last day it applies, YYYY-MM-DD. null clears it. | |
| is_active | No | false pauses it without deleting it. | |
| task_type | No | "schedule": due on its dow, cron or every_days days (exactly one of them). "loop": a member of a loop's queue (then use enqueue_task). "subtask": armed every "every" runs of parent_task_id. | |
| every_days | No | Strict interval: due every N days, counted from start_date (the anchor; defaults to today in the user's time zone). A missed day does not shift the cycle. Schedule tasks/loops only, and instead of dow and cron (send dow 0 / cron null with it). null removes it. | |
| start_date | No | First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it. | |
| description | No | Longer notes. | |
| parent_task_id | No | Subtasks: the parent task's id. | |
| task_missed_behavior | No | Schedule tasks: what happens when a due day passes unchecked. "reschedule" keeps it armed, "drop" skips it automatically (abortions +1). |