things_get_area
Retrieve all to-dos and projects from a specific area in Things 3 to organize and manage tasks effectively.
Instructions
Get all items in a specific area
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area_id | Yes | ||
| max_results | No | Limit number of results returned (defaults to all if not specified) |
Implementation Reference
- src/tools/get.ts:133-143 (handler)The logic for executing the "things_get_area" tool, which uses the area_id from the parameters to call the appropriate AppleScript file.
} else if (toolName === 'things_get_area') { const areaParams = params as z.infer<typeof GetAreaSchema>; scriptArgs = [areaParams.area_id]; } else if (toolName === 'things_get_todo_details') { const todoParams = params as z.infer<typeof GetTodoDetailsSchema>; scriptArgs = [todoParams.id]; // Don't pass maxResults for todo details since it's a single item delete options.maxResults; } const output = await executeAppleScriptFile(scriptName, scriptArgs, options); - src/tools/get.ts:67-70 (registration)Registration of the "things_get_area" tool.
name: 'things_get_area', description: 'Get all items in a specific area', schema: GetAreaSchema },