get_tickler_tasks
Retrieve overdue and today's Todoist tasks labeled for tickler review, returning structured task details including due dates, priorities, and completion status.
Instructions
Get all tickler tasks that are due today or overdue from Todoist. Tickler tasks are tasks with labels #Tickler, #Ansonia Tickler, or #Brian tickler. Returns structured JSON data with task details including id, content, description, completion status, labels, priority, due date, and comment count.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/workflows-tasks.ts:77-89 (handler)The handler function for the 'get_tickler_tasks' tool. It calls getTicklerTasks(), stringifies the result to JSON, and returns it as MCP content.
handler: async () => { console.error('Executing get_tickler_tasks...'); const result = await getTicklerTasks(); console.error('get_tickler_tasks completed successfully'); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }, - src/tools/workflows-tasks.ts:67-76 (schema)The schema definition for the 'get_tickler_tasks' tool, including name, description, and empty input schema.
schema: { name: 'get_tickler_tasks', description: 'Get all tickler tasks that are due today or overdue from Todoist. Tickler tasks are tasks with labels #Tickler, #Ansonia Tickler, or #Brian tickler. Returns structured JSON data with task details including id, content, description, completion status, labels, priority, due date, and comment count.', inputSchema: { type: 'object', properties: {}, required: [], }, }, - src/handlers/tool-request-handler.ts:66-87 (registration)Registration of no-arg tools in toolsWithoutArgs map, dispatching 'get_tickler_tasks' to its handler.
const toolsWithoutArgs: Record<string, () => Promise<ToolResponse>> = { list_personal_inbox_tasks: listPersonalInboxTasksTool.handler, list_brian_inbox_per_becky_tasks: listBrianInboxPerBeckyTasksTool.handler, list_becky_inbox_per_brian_tasks: listBeckyInboxPerBrianTasksTool.handler, list_next_actions: listNextActionsTool.handler, get_brian_only_projects: getBrianOnlyProjectsTool.handler, get_brian_shared_projects: getBrianSharedProjectsTool.handler, get_becky_shared_projects: getBeckySharedProjectsTool.handler, get_inbox_projects: getInboxProjectsTool.handler, get_context_labels: getContextLabelsTool.handler, get_chores_due_today: getChoresDueTodayTool.handler, get_tasks_due_tomorrow: getTasksDueTomorrowTool.handler, get_tasks_due_this_week: getTasksDueThisWeekTool.handler, get_tickler_tasks: getTicklerTasksTool.handler, list_gtd_projects: listGtdProjectsTool.handler, get_waiting_tasks: getWaitingTasksTool.handler, get_recent_media: getRecentMediaTool.handler, get_areas_of_focus: getAreasOfFocusTool.handler, get_shopping_list: getShoppingListTool.handler, list_brian_time_sensitive_tasks: listBrianTimeSensitiveTasksTool.handler, list_becky_time_sensitive_tasks: listBeckyTimeSensitiveTasksTool.handler, }; - Helper function getTicklerTasks that queries Todoist API with filter for tickler tasks due today or overdue, used by the tool handler.
export async function getTicklerTasks(): Promise<TodoistTask[]> { return await fetchRawTasksByFilter( '(today | overdue) & (#Tickler | #Ansonia Tickler | #Brian tickler)', 'get tickler tasks' ); }