things_add_project
Create structured projects in Things 3 with organized sections and tasks. Use headings as visual dividers to group related todos for complex projects with multiple phases or categories.
Instructions
Creates a project in Things with support for sections (headings) and todos. Perfect for complex projects with multiple phases, days, or categories. Headings act as visual dividers - todos that follow a heading in the items array will appear grouped under it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| notes | No | ||
| when | No | Schedule the todo: today/tomorrow/evening (relative), anytime/someday (Things categories), YYYY-MM-DD (specific date), or YYYY-MM-DD@HH:MM (specific time) | |
| deadline | No | ||
| tags | No | ||
| area_id | No | ID of the area to place the project in | |
| area | No | Name of the area to place the project in | |
| items | No | Create a structured project with sections (headings) and todos in a flat array. Each item must have a 'type' field: 'heading' for section dividers, 'todo' for tasks. Items are siblings - todos after a heading are visually grouped under it. Example: [{type: 'heading', title: 'Day 1'}, {type: 'todo', title: 'Morning walk'}, {type: 'todo', title: 'Breakfast'}, {type: 'heading', title: 'Day 2'}, {type: 'todo', title: 'Museum visit'}]. Order matters - todos appear under the most recent heading. | |
| completed | No | ||
| canceled | No |
Implementation Reference
- src/tools/add.ts:30-33 (handler)The implementation of the `things_add_project` tool within the `AddToolHandler` class, which delegates the execution to `jsonBuilder.createProject`.
} else if (toolName === 'things_add_project') { const projectParams = params as z.infer<typeof AddProjectSchema>; return jsonBuilder.createProject(projectParams); } - src/tools/add.ts:20-23 (registration)Registration of the `things_add_project` tool definition in the `AddToolHandler` class.
name: 'things_add_project', description: 'Creates a project in Things with support for sections (headings) and todos. Perfect for complex projects with multiple phases, days, or categories. Headings act as visual dividers - todos that follow a heading in the items array will appear grouped under it.', schema: AddProjectSchema }