DoLoop is an MCP server published by com.getdoloop, hosted at api.getdoloop.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including abort_task, arm_all, check_task, create_loop, create_task.
Recurring tasks in loops. Your assistant reads today's tasks, checks or skips them, edits loops.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Skip an armed task: not this time; the loop moves on. The task is unarmed and its abortions count goes up by 1. On a task that is not armed it changes nothing.
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "abort_task",
"title": "Skip a task",
"description": "Skip an armed task: not this time; the loop moves on. The task is unarmed and its abortions count goes up by 1. On a task that is not armed it changes nothing.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Skip a task",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Run the arming pass the user asked for, in the user's time zone. 1) A scheduled "drop" task still armed from an earlier day is skipped automatically (missed); one armed today is kept; "reschedule" tasks stay armed. 2) Arms every active scheduled task due today that is not armed, except one the user already checked or skipped today. 3) Moves each active loop to its next task, except a loop whose current task is still armed and a schedule loop on a day outside its schedule. A second run on the same day skips nothing and does not bring back scheduled tasks checked or skipped today, but it still advances every loop whose current task is no longer armed (checked, skipped, unarmed or deleted since): not idempotent. Only when the user asks: arming is the user's act.
No parameters.
{
"name": "arm_all",
"title": "Run the arming pass",
"description": "Run the arming pass the user asked for, in the user's time zone. 1) A scheduled \"drop\" task still armed from an earlier day is skipped automatically (missed); one armed today is kept; \"reschedule\" tasks stay armed. 2) Arms every active scheduled task due today that is not armed, except one the user already checked or skipped today. 3) Moves each active loop to its next task, except a loop whose current task is still armed and a schedule loop on a day outside its schedule. A second run on the same day skips nothing and does not bring back scheduled tasks checked or skipped today, but it still advances every loop whose current task is no longer armed (checked, skipped, unarmed or deleted since): not idempotent. Only when the user asks: arming is the user's act.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Run the arming pass",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Mark an armed task as done: it is unarmed and its ticker goes up by 1. On a task that is not armed it changes nothing (compare ticker before and after).
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "check_task",
"title": "Check a task (done)",
"description": "Mark an armed task as done: it is unarmed and its ticker goes up by 1. On a task that is not armed it changes nothing (compare ticker before and after).",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check a task (done)",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create an empty loop (a queue of tasks). Add tasks with enqueue_task.
| Parameter | Type | Description |
|---|---|---|
| dow | integer | 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 | ["string","null"] | 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 … |
| name * | string | Loop name. |
| end_date | ["string","null"] | Last day it applies, YYYY-MM-DD. null clears it. |
| is_active | boolean | false pauses it without deleting it. |
| loop_type | string | "loop" (default): advances to the next task at each arming pass. "schedule": only on its dow, cron or every_days days (exactly one of them). |
| every_days | ["integer","null"] | 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 | ["string","null"] | First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it. |
Create 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.
| Parameter | Type | Description |
|---|---|---|
| dow | integer | 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 | ["string","null"] | 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 … |
| name * | string | Task name. |
| every | ["integer","null"] | Subtasks: armed every N runs of the parent. |
| end_date | ["string","null"] | Last day it applies, YYYY-MM-DD. null clears it. |
| is_active | boolean | false pauses it without deleting it. |
| task_type | string | "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 | ["integer","null"] | 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. |
Delete a loop for good (its tasks are kept). Cannot be undone: confirm with the user first.
| Parameter | Type | Description |
|---|---|---|
| loop_id * | integer | The loop's id (from list_loops). |
{
"name": "delete_loop",
"title": "Delete a loop",
"description": "Delete a loop for good (its tasks are kept). Cannot be undone: confirm with the user first.",
"inputSchema": {
"type": "object",
"required": [
"loop_id"
],
"properties": {
"loop_id": {
"type": "integer",
"minimum": 1,
"description": "The loop's id (from list_loops)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete a loop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Delete a task for good, with its history (ticker, abortions). Cannot be undone: confirm with the user first.
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "delete_task",
"title": "Delete a task",
"description": "Delete a task for good, with its history (ticker, abortions). Cannot be undone: confirm with the user first.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete a task",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Remove a task from a loop's queue (the task itself is kept).
| Parameter | Type | Description |
|---|---|---|
| loop_id * | integer | The loop's id (from list_loops). |
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "dequeue_task",
"title": "Remove a task from a loop",
"description": "Remove a task from a loop's queue (the task itself is kept).",
"inputSchema": {
"type": "object",
"required": [
"loop_id",
"task_id"
],
"properties": {
"loop_id": {
"type": "integer",
"minimum": 1,
"description": "The loop's id (from list_loops)."
},
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Remove a task from a loop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Append one of the user's tasks to the end of a loop's queue.
| Parameter | Type | Description |
|---|---|---|
| loop_id * | integer | The loop's id (from list_loops). |
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "enqueue_task",
"title": "Add a task to a loop",
"description": "Append one of the user's tasks to the end of a loop's queue.",
"inputSchema": {
"type": "object",
"required": [
"loop_id",
"task_id"
],
"properties": {
"loop_id": {
"type": "integer",
"minimum": 1,
"description": "The loop's id (from list_loops)."
},
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add a task to a loop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get one loop with its ordered queue of tasks.
| Parameter | Type | Description |
|---|---|---|
| loop_id * | integer | The loop's id (from list_loops). |
{
"name": "get_loop",
"title": "Get a loop",
"description": "Get one loop with its ordered queue of tasks.",
"inputSchema": {
"type": "object",
"required": [
"loop_id"
],
"properties": {
"loop_id": {
"type": "integer",
"minimum": 1,
"description": "The loop's id (from list_loops)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a loop",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Get one task.
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
{
"name": "get_task",
"title": "Get a task",
"description": "Get one task.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a task",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}List all loops in the user's DoLoop account, each with its ordered queue of tasks and current_task_id.
No parameters.
{
"name": "list_loops",
"title": "List loops",
"description": "List all loops in the user's DoLoop account, each with its ordered queue of tasks and current_task_id.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List loops",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}List all tasks in the user's DoLoop account (every type, armed or not).
No parameters.
{
"name": "list_tasks",
"title": "List tasks",
"description": "List all tasks in the user's DoLoop account (every type, armed or not).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}List the tasks that are armed (due) right now: what the user has to do today.
No parameters.
{
"name": "todays_tasks",
"title": "Today's tasks",
"description": "List the tasks that are armed (due) right now: what the user has to do today.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Today's tasks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Change a loop's fields. Only the fields you pass change; their previous values are overwritten.
| Parameter | Type | Description |
|---|---|---|
| dow | integer | 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 | ["string","null"] | 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 … |
| name | string | Loop name. |
| loop_id * | integer | The loop's id (from list_loops). |
| end_date | ["string","null"] | Last day it applies, YYYY-MM-DD. null clears it. |
| is_active | boolean | false pauses it without deleting it. |
| loop_type | string | "loop" (default): advances to the next task at each arming pass. "schedule": only on its dow, cron or every_days days (exactly one of them). |
| every_days | ["integer","null"] | 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. |
Change a task's fields. Only the fields you pass change; their previous values are overwritten.
| Parameter | Type | Description |
|---|---|---|
| dow | integer | 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 | ["string","null"] | 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 … |
| name | string | Task name. |
| every | ["integer","null"] | Subtasks: armed every N runs of the parent. |
| task_id * | integer | The task's id (from list_tasks, todays_tasks or a loop's tasks). |
| end_date | ["string","null"] | Last day it applies, YYYY-MM-DD. null clears it. |
| is_active | boolean | false pauses it without deleting it. |
| task_type | string | "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. |
DoLoop organises recurring work as tasks and loops. - A task is a unit of work. "armed" means it is due now; checking it marks it done (ticker +1), skipping it (abort_task) means "not this time": abortions +1, and its loop moves on at the next arming pass. Both only act on an armed task. The app calls this action Skip; the API keeps the name abort. - task_type "schedule": due on the days given by ONE schedule system: dow (bitmask Monday=1 ... Saturday=32, Sunday=64; 127 = every day), a cron expression, or every_days (strictly every N days from start_date, e.g. every_days=3 for every third day across month ends). Optionally bounded by start_date/end_date. "loop": a member of a loop's queue. "subtask": armed every "every" runs of its parent_task_id. - A loop is an ordered queue of tasks; it arms one task at a time (current_task_id) and moves to the next when the user runs the arming pass (arm_all). Arming is the user's decision: run arm_all only when the user asks for it, never on your own initiative. - todays_tasks lists what is due now. Use check_task / abort_task to record what the user did. Ask the user before calling a tool marked destructive (update, abort_task/skip, dequeue, arm_all, delete): deletions cannot be undone.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| description | ["string","null"] | Longer notes. |
{
"name": "create_loop",
"title": "Create a loop",
"description": "Create an empty loop (a queue of tasks). Add tasks with enqueue_task.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"dow": {
"type": "integer",
"maximum": 127,
"minimum": 0,
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": "string",
"description": "Loop name."
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Last day it applies, YYYY-MM-DD. null clears it."
},
"is_active": {
"type": "boolean",
"description": "false pauses it without deleting it."
},
"loop_type": {
"enum": [
"loop",
"schedule"
],
"type": "string",
"description": "\"loop\" (default): advances to the next task at each arming pass. \"schedule\": only on its dow, cron or every_days days (exactly one of them)."
},
"every_days": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "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": {
"type": [
"string",
"null"
],
"format": "date",
"description": "First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it."
},
"description": {
"type": [
"string",
"null"
],
"description": "Longer notes."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create a loop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| start_date | ["string","null"] | First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it. |
| description | ["string","null"] | Longer notes. |
| parent_task_id | ["integer","null"] | Subtasks: the parent task's id. |
| task_missed_behavior | ["string","null"] | Schedule tasks: what happens when a due day passes unchecked. "reschedule" keeps it armed, "drop" skips it automatically (abortions +1). |
{
"name": "create_task",
"title": "Create a task",
"description": "Create 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.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"dow": {
"type": "integer",
"maximum": 127,
"minimum": 0,
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": "string",
"description": "Task name."
},
"every": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Subtasks: armed every N runs of the parent."
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Last day it applies, YYYY-MM-DD. null clears it."
},
"is_active": {
"type": "boolean",
"description": "false pauses it without deleting it."
},
"task_type": {
"enum": [
"schedule",
"loop",
"subtask"
],
"type": "string",
"description": "\"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": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "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": {
"type": [
"string",
"null"
],
"format": "date",
"description": "First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it."
},
"description": {
"type": [
"string",
"null"
],
"description": "Longer notes."
},
"parent_task_id": {
"type": [
"integer",
"null"
],
"description": "Subtasks: the parent task's id."
},
"task_missed_behavior": {
"enum": [
"reschedule",
"drop",
null
],
"type": [
"string",
"null"
],
"description": "Schedule tasks: what happens when a due day passes unchecked. \"reschedule\" keeps it armed, \"drop\" skips it automatically (abortions +1)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create a task",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| start_date | ["string","null"] | First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it. |
| description | ["string","null"] | Longer notes. |
{
"name": "update_loop",
"title": "Update a loop",
"description": "Change a loop's fields. Only the fields you pass change; their previous values are overwritten.",
"inputSchema": {
"type": "object",
"required": [
"loop_id"
],
"properties": {
"dow": {
"type": "integer",
"maximum": 127,
"minimum": 0,
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": "string",
"description": "Loop name."
},
"loop_id": {
"type": "integer",
"minimum": 1,
"description": "The loop's id (from list_loops)."
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Last day it applies, YYYY-MM-DD. null clears it."
},
"is_active": {
"type": "boolean",
"description": "false pauses it without deleting it."
},
"loop_type": {
"enum": [
"loop",
"schedule"
],
"type": "string",
"description": "\"loop\" (default): advances to the next task at each arming pass. \"schedule\": only on its dow, cron or every_days days (exactly one of them)."
},
"every_days": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "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": {
"type": [
"string",
"null"
],
"format": "date",
"description": "First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it."
},
"description": {
"type": [
"string",
"null"
],
"description": "Longer notes."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Update a loop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}| every_days | ["integer","null"] | 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 | ["string","null"] | First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it. |
| description | ["string","null"] | Longer notes. |
| parent_task_id | ["integer","null"] | Subtasks: the parent task's id. |
| task_missed_behavior | ["string","null"] | Schedule tasks: what happens when a due day passes unchecked. "reschedule" keeps it armed, "drop" skips it automatically (abortions +1). |
{
"name": "update_task",
"title": "Update a task",
"description": "Change a task's fields. Only the fields you pass change; their previous values are overwritten.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"dow": {
"type": "integer",
"maximum": 127,
"minimum": 0,
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": "string",
"description": "Task name."
},
"every": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Subtasks: armed every N runs of the parent."
},
"task_id": {
"type": "integer",
"minimum": 1,
"description": "The task's id (from list_tasks, todays_tasks or a loop's tasks)."
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Last day it applies, YYYY-MM-DD. null clears it."
},
"is_active": {
"type": "boolean",
"description": "false pauses it without deleting it."
},
"task_type": {
"enum": [
"schedule",
"loop",
"subtask"
],
"type": "string",
"description": "\"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": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "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": {
"type": [
"string",
"null"
],
"format": "date",
"description": "First day it applies, YYYY-MM-DD; with every_days, the first day of the interval. null clears it."
},
"description": {
"type": [
"string",
"null"
],
"description": "Longer notes."
},
"parent_task_id": {
"type": [
"integer",
"null"
],
"description": "Subtasks: the parent task's id."
},
"task_missed_behavior": {
"enum": [
"reschedule",
"drop",
null
],
"type": [
"string",
"null"
],
"description": "Schedule tasks: what happens when a due day passes unchecked. \"reschedule\" keeps it armed, \"drop\" skips it automatically (abortions +1)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Update a task",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}