create_recurring_task
Create a recurring task. It generates task instances on a schedule, each with the reminders set in reminderOffsetMinutes.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"notes": "Blue bin only",
"title": "Take out the recycling",
"endDate": "2026-12-31",
"startDate": "2026-08-01",
"cronExpression": "2 Week",
"maxOccurrences": 26,
"assigneeRotation": [
"7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e",
"a1b2c3d4e5f60718293a4b5c6d7e8f90"
],
"reminderOffsetMinutes": [
1440
]
},
"name": "create_recurring_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Notes copied to every generated instance. | |
| title | Yes | Title given to every generated instance. | |
| endDate | No | Inclusive last date, YYYY-MM-DD. Omit for open-ended. | |
| isUrgent | No | Mark every task this series generates as urgent. | |
| startDate | No | First date to generate from, YYYY-MM-DD. Defaults to today. | |
| cronExpression | Yes | Interval as 'N Unit', Unit one of Day, Week, Month, Year, e.g. '2 Week'. Not cron syntax. | |
| maxOccurrences | No | Cap on instances generated, applied even if endDate is not reached. | |
| preparationDays | No | Legacy single reminder, days before each occurrence's due date, 0-365 (0 means none); use reminderOffsetMinutes instead. Ignored when reminderOffsetMinutes is sent. | |
| assigneeRotation | No | A member id from list_house_members. | |
| reminderOffsetMinutes | No | Reminder lead times, in minutes before each generated task's due date. Each value is whole hours, 60-1380 (1-23 hours), or whole days, a multiple of 1440 up to 40320 (4 weeks, the most for a repeating item); a week is 10080. Up to 5 values. A due date counts from 00:00 on that day, so 300 (5 hours) is 19:00 the evening before. Day and week reminders arrive at 19:00 on the earlier day; hour reminders arrive that many hours before, or up to 15 minutes earlier. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| title | No | ||
| message | No | ||
| variant | No |