create_chore
Create a chore with flexible repeat options, assign it to users or a circle, set due dates, add subtasks, labels, and configure reminders.
Instructions
Create a new chore. Use simple inputs like usernames and day names.
EXAMPLES:
Simple: {name: 'Take out trash', days_of_week: ['Mon','Thu'], time_of_day: '19:00', usernames: ['Alice']}
One-time: {name: 'Fix faucet', due_date: '2025-11-10', priority: 3}
With subtasks: {name: 'Weekly review', subtask_names: ['Check email','Update notes']}
If no usernames provided, chore is assigned to ANYONE in the circle (round-robin).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Chore name (required, 1-200 chars) | |
| points | No | Points awarded on completion | |
| due_date | No | Due date: YYYY-MM-DD or RFC3339 | |
| priority | No | 0=unset, 1=lowest, 2=low, 3=medium, 4=highest | |
| timezone | No | IANA timezone (default: America/New_York) | |
| frequency | No | Multiplier (e.g., 2=biweekly). Default: 1 | |
| usernames | No | Assign by username/display name. First becomes primary assignee. If omitted, assigned to anyone. | |
| is_private | No | Visible only to creator. Default: false | |
| is_rolling | No | Next due based on completion (true) vs fixed schedule (false). Default: false | |
| description | No | Chore description | |
| label_names | No | Labels by name (e.g., ['cleaning','urgent']). Must exist first — use create_label. | |
| time_of_day | No | Time in HH:MM format (e.g., '16:00') | |
| days_of_week | No | Days as short names: ['Mon','Wed','Fri']. Auto-sets frequency_type to days_of_the_week. | |
| subtask_names | No | Checklist items: ['Step 1','Step 2'] | |
| enable_nagging | No | Repeated reminders until completed. Default: false | |
| frequency_type | No | How often it repeats (default: once). Use 'days_of_the_week' with days_of_week param for specific days. | |
| assign_strategy | No | How to rotate assignment. Default: round_robin (when anyone) or least_completed (when specific users) | |
| require_approval | No | Require approval to mark complete. Default: false | |
| remind_at_due_time | No | Remind exactly at due time. Default: false | |
| remind_minutes_before | No | Remind X minutes before due time |