feat: Add isUncompletable parameter support to add/update tools

package.json

@@ -48,7 +48,7 @@
         "prepare": "husky"
     },
     "dependencies": {
-        "@doist/todoist-api-typescript": "6.1.12",
+        "@doist/todoist-api-typescript": "6.2.0",
         "@modelcontextprotocol/sdk": "1.22.0",
         "date-fns": "4.1.0",
         "dotenv": "17.2.3",

src/tools/__tests__/add-tasks.test.ts

@@ -786,4 +786,38 @@ describe(`${ADD_TASKS} tool`, () => {
             })
         })
     })
+
+    describe('isUncompletable parameter', () => {
+        it('should pass isUncompletable parameter to SDK', async () => {
+            // Mock API response - minimal mock just to prevent errors
+            const mockApiResponse: Task = createMockTask({
+                id: '8485093999',
+                content: 'Project Header',
+            })
+
+            mockTodoistApi.addTask.mockResolvedValueOnce(mockApiResponse)
+
+            await addTasks.execute(
+                {
+                    tasks: [
+                        {
+                            content: 'Project Header',
+                            isUncompletable: true,
+                        },
+                    ],
+                },
+                mockTodoistApi,
+            )
+
+            // Verify the parameter was passed to the SDK - this is the key test
+            expect(mockTodoistApi.addTask).toHaveBeenCalledWith({
+                content: 'Project Header',
+                projectId: undefined,
+                sectionId: undefined,
+                parentId: undefined,
+                labels: undefined,
+                isUncompletable: true,
+            })
+        })
+    })
 })

src/tools/__tests__/update-tasks.test.ts

@@ -1031,4 +1031,33 @@ describe(`${UPDATE_TASKS} tool`, () => {
             })
         })
     })
+
+    describe('isUncompletable parameter', () => {
+        it('should pass isUncompletable parameter to SDK', async () => {
+            // Mock API response - minimal mock just to prevent errors
+            const mockUpdatedTask: Task = createMockTask({
+                id: 'task123',
+                content: 'Updated Header',
+            })
+
+            mockTodoistApi.updateTask.mockResolvedValueOnce(mockUpdatedTask)
+
+            await updateTasks.execute(
+                {
+                    tasks: [
+                        {
+                            id: 'task123',
+                            isUncompletable: true,
+                        },
+                    ],
+                },
+                mockTodoistApi,
+            )
+
+            // Verify the parameter was passed to the SDK - this is the key test
+            expect(mockTodoistApi.updateTask).toHaveBeenCalledWith('task123', {
+                isUncompletable: true,
+            })
+        })
+    })
 })

src/tools/add-tasks.ts

@@ -53,6 +53,12 @@ const TaskSchema = z.object({
         .describe(
             'Assign task to this user. Can be a user ID, name, or email address. User must be a collaborator on the target project.',
         ),
+    isUncompletable: z
+        .boolean()
+        .optional()
+        .describe(
+            'Whether this task should be uncompletable (organizational header). Tasks with isUncompletable: true appear as organizational headers and cannot be completed.',
+        ),
 })
 
 const ArgsSchema = {

src/tools/update-tasks.ts

@@ -61,6 +61,12 @@ const TasksUpdateSchema = z.object({
         .array(z.string())
         .optional()
         .describe('The new labels for the task. Replaces all existing labels.'),
+    isUncompletable: z
+        .boolean()
+        .optional()
+        .describe(
+            'Whether this task should be uncompletable (organizational header). Tasks with isUncompletable: true appear as organizational headers and cannot be completed.',
+        ),
 })
 
 type TaskUpdate = z.infer<typeof TasksUpdateSchema>

src/utils/output-schemas.ts

@@ -28,6 +28,10 @@ const TaskSchema = z.object({
         .string()
         .optional()
         .describe('The UID of the user responsible for this task.'),
+    isUncompletable: z
+        .boolean()
+        .optional()
+        .describe('Whether the task is uncompletable (organizational header).'),
     assignedByUid: z.string().optional().describe('The UID of the user who assigned this task.'),
     checked: z.boolean().describe('Whether the task is checked/completed.'),
     completedAt: z.string().optional().describe('When the task was completed (ISO 8601 format).'),

src/utils/test-helpers.ts

@@ -41,6 +41,7 @@ export function createMockTask({
         dayOrder: 0,
         userId: '713437',
         priority: convertPriorityToNumber(priority),
+        isUncompletable: false,
         ...overrides,
     }
 }