add_todo
Create and manage to-do items in Things.app with notes, deadlines, tags, sub-tasks, and project assignments. Schedule, organize, and track tasks efficiently using actionable inputs and structured data.
Instructions
Create a new to-do item in Things.app. Add notes, tags, checklist items, and assign to projects or areas.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| areaId | No | ID of the area of responsibility to assign this to-do to. Use this when you know the specific area ID | |
| areaName | No | Name of the area of responsibility to assign this to-do to (e.g., "Work", "Personal", "Health") | |
| canceled | No | Mark the to-do as canceled immediately upon creation (default: false). Useful for recording tasks that are no longer needed | |
| checklistItems | No | Array of checklist item descriptions to add as sub-tasks (max 100 items). Each item becomes a checkable sub-task within the to-do | |
| completed | No | Mark the to-do as completed immediately upon creation (default: false). Useful for logging already completed tasks | |
| completionDate | No | Set a specific completion date using ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Only used when completed is true | |
| creationDate | No | Override the creation date with a specific ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Useful for importing historical data | |
| deadline | No | Set a deadline for the to-do in ISO date format (YYYY-MM-DD). Creates a deadline reminder in Things.app | |
| headingId | No | ID of a specific heading within the target project to organize the to-do under | |
| headingName | No | Name of a heading within the target project to organize the to-do under (e.g., "Phase 1", "Research") | |
| notes | No | Additional notes or details for the to-do (max 10,000 characters). Supports markdown formatting for rich text | |
| projectId | No | ID of the project to add this to-do to. Use this when you know the specific project ID | |
| projectName | No | Name of the project to add this to-do to. Things.app will find the project by name and add the to-do there | |
| tags | No | Array of tag names for organizing and categorizing the to-do (max 20 tags). Tags help with filtering and organization | |
| title | Yes | To-do title (required). Clear, actionable description of the task | |
| when | No | Schedule the to-do for a specific time. Use "today" for immediate action, "tomorrow" for next day, "evening" for later today, "anytime" for no specific time, "someday" for future consideration, or ISO date format (YYYY-MM-DD) for specific date |