add_project
Create a new project in Things.app with notes, tags, area assignment, and initial to-dos. Schedule start dates, set deadlines, and mark as completed or canceled. Supports markdown notes and date overrides for historical imports.
Instructions
Create a new project in Things.app. Add notes, tags, assign to areas, and pre-populate with initial to-dos.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Project title (required). Clear name describing the project goal, outcome, or deliverable | |
| notes | No | Project description, objectives, scope, or additional context (max 10,000 characters). Supports markdown formatting for rich text documentation | |
| when | No | Schedule 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 | |
| deadline | No | Set a deadline for project completion in ISO date format (YYYY-MM-DD). Creates deadline tracking and reminders in Things.app | |
| tags | No | Array of tag names for categorizing and organizing the project (max 20 tags). Tags help with filtering and project management | |
| areaId | No | ID of the area of responsibility to assign this project to. Use this when you know the specific area ID | |
| areaName | No | Name of the area of responsibility to assign this project to (e.g., "Work", "Personal", "Health", "Finance"). Areas help organize projects by life domain | |
| initialTodos | No | Array of initial to-do item descriptions to create within the project (max 50 items). Each string becomes a separate task within the project | |
| completed | No | Mark the project as completed immediately upon creation (default: false). Useful for logging already completed projects | |
| canceled | No | Mark the project as canceled immediately upon creation (default: false). Useful for recording projects that are no longer viable | |
| creationDate | No | Override the creation date with a specific ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Useful for importing historical project data | |
| completionDate | No | Set a specific completion date using ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Only used when completed is true |