Todoist MCP Server

Instructions

Implementation Reference

• src/tools/workflows-tasks.ts:12-36 (handler)

  The complete tool definition for 'get_chores_due_today', including schema and the handler function that calls the helper getChoresDueToday() and returns the result as JSON text content.
  export const getChoresDueTodayTool: Tool = { schema: { name: 'get_chores_due_today', description: 'Get all chores due today or overdue from Todoist using the filter "(today | overdue) & ##Chores". Returns structured JSON data with chore details including id, content, due date, project_id, and labels.', inputSchema: { type: 'object', properties: {}, required: [], }, }, handler: async () => { console.error('Executing get_chores_due_today...'); const result = await getChoresDueToday(); console.error('get_chores_due_today completed successfully'); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }, };
• src/tools/workflows-tasks.ts:13-22 (schema)

  The schema definition for the get_chores_due_today tool, specifying name, description, and empty input schema.
  schema: { name: 'get_chores_due_today', description: 'Get all chores due today or overdue from Todoist using the filter "(today | overdue) & ##Chores". Returns structured JSON data with chore details including id, content, due date, project_id, and labels.', inputSchema: { type: 'object', properties: {}, required: [], }, },
• src/services/tasks/task-retrieval.ts:89-94 (helper)

  The helper function getChoresDueToday that fetches chores due today or overdue from Todoist using a specific filter and the shared fetchRawTasksByFilter utility.
  export async function getChoresDueToday(): Promise<TodoistTask[]> { return await fetchRawTasksByFilter( '(today | overdue) & ##Chores', 'get chores due today' ); }
• src/handlers/tool-request-handler.ts:66-87 (registration)

  Registration of the get_chores_due_today handler in the toolsWithoutArgs registry used by handleToolRequest.
  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, };
• src/index.ts:102-103 (registration)

  Registration of the tool schema in the list of tools returned by ListToolsRequestHandler.
  searchTasksUsingOrTool.schema, getChoresDueTodayTool.schema,