@doist/todoist-ai 4.7.1 → 4.8.0

package/dist/mcp-server.js

@@ -40,7 +40,7 @@ You have access to comprehensive Todoist management tools for personal productiv
 - **update-tasks**: Modify existing tasks - get task IDs from search results first, only include fields that need changes
 - **complete-tasks**: Mark tasks as done using task IDs
 - **find-tasks**: Search by text, project/section/parent container, responsible user, or labels. Requires at least one search parameter
-- **find-tasks-by-date**: Get tasks by date range (startDate: YYYY-MM-DD, 'today', or 'overdue') or specific day counts
+- **find-tasks-by-date**: Get tasks by date range (startDate: YYYY-MM-DD or 'today' which includes overdue tasks) or specific day counts
 - **find-completed-tasks**: View completed tasks by completion date or original due date
 
 **Project & Organization:**
@@ -67,7 +67,7 @@ You have access to comprehensive Todoist management tools for personal productiv
 
 4. **Bulk Operations**: When working with multiple items, prefer bulk tools (complete-tasks, manage-assignments) over individual operations for better performance.
 
-5. **Date Handling**: All dates respect user timezone settings. Use 'today' and 'overdue' keywords for dynamic date filtering.
+5. **Date Handling**: All dates respect user timezone settings. Use 'today' keyword for dynamic date filtering (includes overdue tasks).
 
 6. **Labels**: Use label filtering with AND/OR operators for advanced task organization. Most search tools support labels parameter.
 

package/dist/tools/__tests__/add-tasks.test.js

@@ -249,9 +249,7 @@ describe(`${ADD_TASKS} tool`, () => {
             // Verify structured content includes labels
             const structuredContent = extractStructuredContent(result);
             expect(structuredContent.tasks).toHaveLength(1);
-            expect(structuredContent.tasks[0]).toEqual(expect.objectContaining({
-                labels: ['urgent', 'work'],
-            }));
+            expect(structuredContent.tasks).toEqual(expect.arrayContaining([expect.objectContaining({ labels: ['urgent', 'work'] })]));
         });
         it('should add task with empty labels array', async () => {
             const mockApiResponse = createMockTask({

package/dist/tools/__tests__/complete-tasks.test.js

@@ -139,7 +139,7 @@ describe(`${COMPLETE_TASKS} tool`, () => {
             const result = await completeTasks.execute({ ids: ['task-1', 'task-2'] }, mockTodoistApi);
             const textContent = extractTextContent(result);
             expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain("Use find-tasks-by-date('overdue')");
+            expect(textContent).toContain("Use find-tasks-by-date('today')");
         });
         it('should suggest reviewing failures when mixed results', async () => {
             mockTodoistApi.closeTask

package/dist/tools/__tests__/find-tasks-by-date.test.js

@@ -36,55 +36,15 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
     afterEach(() => {
         jest.restoreAllMocks();
     });
-    describe('listing overdue tasks', () => {
-        it.each([
-            { daysCount: 7, hasTasks: true, description: 'with tasks' },
-            { daysCount: 5, hasTasks: false, description: 'ignoring daysCount' },
-        ])('should handle overdue tasks $description', async ({ daysCount, hasTasks }) => {
-            const mockTasks = hasTasks
-                ? [
-                    createMappedTask({
-                        id: TEST_IDS.TASK_1,
-                        content: 'Overdue task',
-                        dueDate: '2025-08-10',
-                        priority: 2,
-                        labels: ['urgent'],
-                    }),
-                ]
-                : [];
-            const mockResponse = { tasks: mockTasks, nextCursor: null };
-            mockGetTasksByFilter.mockResolvedValue(mockResponse);
-            const result = await findTasksByDate.execute({ startDate: 'overdue', limit: 50, daysCount }, mockTodoistApi);
-            expect(mockGetTasksByFilter).toHaveBeenCalledWith({
-                client: mockTodoistApi,
-                query: 'overdue',
-                cursor: undefined,
-                limit: 50,
-            });
-            // Verify result is a concise summary
-            expect(extractTextContent(result)).toMatchSnapshot();
-            // Verify structured content
-            const structuredContent = extractStructuredContent(result);
-            expect(structuredContent.tasks).toHaveLength(hasTasks ? 1 : 0);
-            expect(structuredContent).toEqual(expect.objectContaining({
-                totalCount: hasTasks ? 1 : 0,
-                hasMore: false,
-                nextCursor: null,
-                appliedFilters: expect.objectContaining({
-                    startDate: 'overdue',
-                }),
-            }));
-        });
-    });
     describe('listing tasks by date range', () => {
-        it('should get tasks for today when startDate is "today"', async () => {
+        it('should get tasks for today when startDate is "today" (includes overdue)', async () => {
             const mockTasks = [createMappedTask({ content: 'Today task', dueDate: '2025-08-15' })];
             const mockResponse = { tasks: mockTasks, nextCursor: null };
             mockGetTasksByFilter.mockResolvedValue(mockResponse);
             const result = await findTasksByDate.execute({ startDate: 'today', limit: 50, daysCount: 7 }, mockTodoistApi);
             expect(mockGetTasksByFilter).toHaveBeenCalledWith({
                 client: mockTodoistApi,
-                query: expect.stringContaining('due after:') && expect.stringContaining('due before:'),
+                query: 'today | overdue',
                 cursor: undefined,
                 limit: 50,
             });
@@ -217,29 +177,13 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
             expect(textContent).toMatchSnapshot();
             expect(textContent).toContain(`Use ${UPDATE_TASKS} to modify priorities or due dates`);
         });
-        it('should suggest appropriate actions when startDate is overdue', async () => {
-            const mockTasks = [
-                createMappedTask({
-                    id: TEST_IDS.TASK_1,
-                    content: 'Overdue task',
-                    dueDate: '2025-08-10',
-                }),
-            ];
-            const mockResponse = { tasks: mockTasks, nextCursor: null };
-            mockGetTasksByFilter.mockResolvedValue(mockResponse);
-            const result = await findTasksByDate.execute({ startDate: 'overdue', limit: 10, daysCount: 1 }, mockTodoistApi);
-            const textContent = extractTextContent(result);
-            expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain(`Use ${UPDATE_TASKS} to modify priorities or due dates`);
-        });
-        it('should provide helpful suggestions for empty overdue results', async () => {
+        it('should provide helpful suggestions for empty today results', async () => {
             const mockResponse = { tasks: [], nextCursor: null };
             mockGetTasksByFilter.mockResolvedValue(mockResponse);
-            const result = await findTasksByDate.execute({ startDate: 'overdue', limit: 10, daysCount: 1 }, mockTodoistApi);
+            const result = await findTasksByDate.execute({ startDate: 'today', limit: 10, daysCount: 1 }, mockTodoistApi);
             const textContent = extractTextContent(result);
             expect(textContent).toMatchSnapshot();
-            expect(textContent).toContain('Great job! No overdue tasks');
-            expect(textContent).toContain("Check today's tasks with startDate='today'");
+            expect(textContent).toContain('Great job! No tasks for today or overdue');
         });
         it('should provide helpful suggestions for empty date range results', async () => {
             const mockResponse = { tasks: [], nextCursor: null };
@@ -252,7 +196,7 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
             const textContent = extractTextContent(result);
             expect(textContent).toMatchSnapshot();
             expect(textContent).toContain("Expand date range with larger 'daysCount'");
-            expect(textContent).toContain("Check 'overdue' for past-due items");
+            expect(textContent).toContain("Check today's tasks with startDate='today'");
         });
     });
     describe('label filtering', () => {
@@ -265,18 +209,18 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
                     limit: 50,
                     labels: ['work'],
                 },
-                expectedQueryPattern: '((@work))', // Will be combined with date query
+                expectedQueryPattern: 'today | overdue & ((@work))', // Will be combined with date query
             },
             {
                 name: 'multiple labels with AND operator',
                 params: {
-                    startDate: 'overdue',
+                    startDate: 'today',
                     daysCount: 1,
                     limit: 50,
                     labels: ['work', 'urgent'],
                     labelsOperator: 'and',
                 },
-                expectedQueryPattern: 'overdue & ((@work  &  @urgent))',
+                expectedQueryPattern: 'today | overdue & ((@work  &  @urgent))',
             },
             {
                 name: 'multiple labels with OR operator',
@@ -307,8 +251,8 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
                 cursor: undefined,
                 limit: 50,
             });
-            // For overdue specifically, check the exact pattern
-            if (params.startDate === 'overdue') {
+            // For today specifically, check the exact pattern
+            if (params.startDate === 'today') {
                 expect(mockGetTasksByFilter).toHaveBeenCalledWith({
                     client: mockTodoistApi,
                     query: expectedQueryPattern,
@@ -374,7 +318,7 @@ describe(`${FIND_TASKS_BY_DATE} tool`, () => {
             },
             {
                 error: TEST_ERRORS.API_RATE_LIMIT,
-                params: { startDate: 'overdue', limit: 50, daysCount: 7 },
+                params: { startDate: 'today', limit: 50, daysCount: 7 },
             },
             {
                 error: TEST_ERRORS.INVALID_CURSOR,

package/dist/tools/complete-tasks.js

@@ -45,7 +45,7 @@ const completeTasks = {
 function generateNextSteps(completed, failures) {
     if (completed > 0) {
         const moveResult = failures === 0
-            ? "Use find-tasks-by-date('overdue') to tackle remaining overdue items."
+            ? "Use find-tasks-by-date('today') to tackle remaining overdue items."
             : 'Review failed completions and retry if needed.';
         return [moveResult];
     }

package/dist/tools/find-tasks-by-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-tasks-by-date.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks-by-date.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDqB,CAAA;AAyE1C,OAAO,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"find-tasks-by-date.d.ts","sourceRoot":"","sources":["../../src/tools/find-tasks-by-date.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA0CvB,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDqB,CAAA;AAoE1C,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/tools/find-tasks-by-date.js

@@ -9,15 +9,15 @@ import { ToolNames } from '../utils/tool-names.js';
 const ArgsSchema = {
     startDate: z
         .string()
-        .regex(/^(\d{4}-\d{2}-\d{2}|today|overdue)$/)
-        .describe("The start date to get the tasks for. Format: YYYY-MM-DD, 'today', or 'overdue'."),
+        .regex(/^(\d{4}-\d{2}-\d{2}|today)$/)
+        .describe("The start date to get the tasks for. Format: YYYY-MM-DD or 'today'."),
     daysCount: z
         .number()
         .int()
         .min(1)
         .max(30)
         .default(1)
-        .describe("The number of days to get the tasks for, starting from the start date. Ignored when startDate is 'overdue'."),
+        .describe('The number of days to get the tasks for, starting from the start date.'),
     limit: z
         .number()
         .int()
@@ -33,17 +33,15 @@ const ArgsSchema = {
 };
 const findTasksByDate = {
     name: ToolNames.FIND_TASKS_BY_DATE,
-    description: "Get tasks by date range or overdue tasks. Use startDate 'overdue' for overdue tasks, or provide a date/date range.",
+    description: "Get tasks by date range. Use startDate 'today' to get today's tasks including overdue items, or provide a specific date/date range.",
     parameters: ArgsSchema,
     async execute(args, client) {
         let query = '';
-        if (args.startDate === 'overdue') {
-            query = 'overdue';
+        if (args.startDate === 'today') {
+            query = 'today | overdue';
         }
         else {
-            const startDate = args.startDate === 'today'
-                ? formatISO(new Date(), { representation: 'date' })
-                : args.startDate;
+            const startDate = args.startDate;
             const endDate = addDays(startDate, args.daysCount + 1);
             const endDateStr = formatISO(endDate, { representation: 'date' });
             query = `(due after: ${startDate} | due: ${startDate}) & due before: ${endDateStr}`;
@@ -82,11 +80,8 @@ const findTasksByDate = {
 function generateTextContent({ tasks, args, nextCursor, }) {
     // Generate filter description
     const filterHints = [];
-    if (args.startDate === 'overdue') {
-        filterHints.push('overdue tasks only');
-    }
-    else if (args.startDate === 'today') {
-        filterHints.push(`today${args.daysCount > 1 ? ` + ${args.daysCount - 1} more days` : ''}`);
+    if (args.startDate === 'today') {
+        filterHints.push(`today + overdue tasks${args.daysCount > 1 ? ` + ${args.daysCount - 1} more days` : ''}`);
     }
     else {
         filterHints.push(`${args.startDate}${args.daysCount > 1 ? ` to ${getDateString(addDays(args.startDate, args.daysCount))}` : ''}`);
@@ -99,21 +94,16 @@ function generateTextContent({ tasks, args, nextCursor, }) {
         filterHints.push(`labels: ${labelText}`);
     }
     // Generate subject description
-    const subject = args.startDate === 'overdue'
-        ? 'Overdue tasks'
-        : args.startDate === 'today'
-            ? `Today's tasks`
-            : `Tasks for ${args.startDate}`;
+    const subject = args.startDate === 'today' ? `Today's tasks + overdue` : `Tasks for ${args.startDate}`;
     // Generate helpful suggestions for empty results
     const zeroReasonHints = [];
     if (tasks.length === 0) {
-        if (args.startDate === 'overdue') {
-            zeroReasonHints.push('Great job! No overdue tasks');
-            zeroReasonHints.push("Check today's tasks with startDate='today'");
+        if (args.startDate === 'today') {
+            zeroReasonHints.push('Great job! No tasks for today or overdue');
         }
         else {
             zeroReasonHints.push("Expand date range with larger 'daysCount'");
-            zeroReasonHints.push("Check 'overdue' for past-due items");
+            zeroReasonHints.push("Check today's tasks with startDate='today'");
         }
     }
     // Generate contextual next steps
@@ -121,7 +111,7 @@ function generateTextContent({ tasks, args, nextCursor, }) {
     const todayStr = getDateString(now);
     const nextSteps = generateTaskNextSteps('listed', tasks, {
         hasToday: args.startDate === 'today' || tasks.some((task) => task.dueDate === todayStr),
-        hasOverdue: args.startDate === 'overdue' ||
+        hasOverdue: args.startDate === 'today' ||
             tasks.some((task) => task.dueDate && new Date(task.dueDate) < now),
     });
     return summarizeList({

package/dist/utils/response-builders.js

@@ -148,7 +148,7 @@ export function generateTaskNextSteps(operation, tasks, context) {
                 nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to review today's updated schedule`);
             }
             else if (context?.hasOverdue) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('overdue') to prioritize past-due items`);
+                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to prioritize past-due items`);
             }
             else if (context?.projectName) {
                 nextSteps.push(`Use ${GET_OVERVIEW} with projectId to see ${context.projectName} structure`);
@@ -178,7 +178,7 @@ export function generateTaskNextSteps(operation, tasks, context) {
                 nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('tomorrow') to plan upcoming work`);
             }
             else if (context?.hasOverdue) {
-                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('overdue') to tackle remaining past-due items`);
+                nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to tackle remaining past-due items`);
             }
             else {
                 nextSteps.push(`Use ${FIND_TASKS_BY_DATE}('today') to see remaining work`);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "4.7.1",
+    "version": "4.8.0",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",