update_project
Modify an existing project in Things.app by updating title, notes, scheduling, tags, area assignment, and completion status. Use this tool to reschedule deadlines, add progress updates, or mark projects as complete or canceled.
Instructions
Update an existing project in Things.app. Modify title, notes, scheduling, tags, area assignment, and completion status.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addTags | No | Add these tag names to existing tags without removing current ones (max 20 total tags). Preserves existing project tags | |
| appendNotes | No | Add text to the end of existing notes without replacing them. Useful for adding progress updates or new requirements | |
| areaId | No | Move the project to a different area of responsibility by specifying the area ID | |
| areaName | No | Move the project to a different area of responsibility by specifying the area name (e.g., "Work", "Personal", "Health", "Finance") | |
| canceled | No | Mark the project as canceled (true) or restore it (false). Canceled projects are moved to the Trash along with all their to-dos | |
| completed | No | Mark the project as completed (true) or reopen it (false). Completed projects are moved to the Logbook along with all their to-dos | |
| completionDate | No | Set a specific completion date using ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Only used when marking the project as completed | |
| creationDate | No | Override the creation date with a specific ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Useful for data migration or historical project tracking | |
| deadline | No | Update the project deadline in ISO date format (YYYY-MM-DD). Creates or updates deadline tracking and reminders in Things.app | |
| id | Yes | The unique ID of the project to update. This ID can be obtained from the list_projects tool | |
| notes | No | Replace existing notes with new project description, objectives, or context (max 10,000 characters). Supports markdown formatting. This completely replaces existing notes | |
| prependNotes | No | Add text to the beginning of existing notes without replacing them. Useful for adding project updates or new objectives | |
| tags | No | Replace all current tags with this new set of tag names (max 20 tags). This completely replaces existing tags for the project | |
| title | No | Update the project title with a new clear name describing the project goal, outcome, or deliverable | |
| when | No | Reschedule when to start working on this project. Use "today" to start immediately, "tomorrow" to start next day, "evening" to start later today, "anytime" for flexible timing, "someday" for future consideration, or ISO date format (YYYY-MM-DD) for specific start date |