Skip to content
This repository was archived by the owner on Sep 16, 2025. It is now read-only.

Commit 157839d

Browse files
authored
Fix: clarify dueString parameter usage for removing task due dates (#79)
fixes #78 ## Description This PR improves the documentation for the `dueString` parameter in the `update-task` tool to clarify how to remove existing due dates from tasks. ## Problem The current parameter description only mentions setting due dates but doesn't explain how to remove them. This has led to confusion where AI agents and developers attempt to use `null` or empty strings to remove due dates, which doesn't work with the Todoist API. ## Solution Updated the `dueString` parameter description to explicitly mention that `"no date"` or `"no due date"` should be used to remove existing due dates. ### Changes Made - **File**: `src/tools/update-task.ts` - **Change**: Updated the `describe()` method for the `dueString` parameter ## Testing ✅ Verified that `dueString: "no date"` successfully removes due dates ✅ Verified that `dueString: "no due date"` successfully removes due dates ✅ Confirmed that empty strings and null values do not remove due dates (as expected) ✅ Existing functionality for setting due dates remains unchanged ## Related - Aligns with [Todoist REST API documentation](https://developer.todoist.com/rest/v2/#update-a-task) - Improves developer experience and AI agent compatibility - No breaking changes to existing functionality
1 parent f12447a commit 157839d

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

src/tools/update-task.ts

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ export function registerUpdateTask(server: McpServer, api: TodoistApi) {
2424
dueString: z
2525
.string()
2626
.optional()
27-
.describe('Natural language description of due date like "tomorrow at 3pm"'),
27+
.describe(
28+
'Natural language description of due date like "tomorrow at 3pm". Use "no date" or "no due date" to remove an existing due date.',
29+
),
2830
dueLang: z
2931
.string()
3032
.optional()

0 commit comments

Comments
 (0)