feat: Adds completed tasks tool (#8)

This adds a new tool that allows for fetching of completed tasks either
by due date or by completion date.

---------

Co-authored-by: Ernesto García <[email protected]>

Author: scottlovegrove

src/index.ts

@@ -26,6 +26,7 @@ import { subtasksListForParentTask } from './tools/subtasks-list-for-parent-task
 
 import { accountOverview } from './tools/account-overview'
 import { projectOverview } from './tools/project-overview'
+import { tasksListCompleted } from './tools/tasks-list-completed'
 
 const tools = {
     projectsList,
@@ -42,6 +43,7 @@ const tools = {
     tasksCompleteMultiple,
     tasksListForProject,
     tasksListOverdue,
+    tasksListCompleted,
     tasksSearch,
     tasksAddMultiple,
     tasksUpdateOne,

src/mcp-server.ts

@@ -21,6 +21,7 @@ import { tasksAddMultiple } from './tools/tasks-add-multiple'
 import { tasksCompleteMultiple } from './tools/tasks-complete-multiple'
 import { tasksDeleteOne } from './tools/tasks-delete-one'
 import { tasksListByDate } from './tools/tasks-list-by-date'
+import { tasksListCompleted } from './tools/tasks-list-completed'
 import { tasksListForProject } from './tools/tasks-list-for-project'
 import { tasksListForSection } from './tools/tasks-list-for-section'
 import { tasksListOverdue } from './tools/tasks-list-overdue'
@@ -51,6 +52,7 @@ function getMcpServer({ todoistApiKey, baseUrl }: { todoistApiKey: string; baseU
 
     const todoist = new TodoistApi(todoistApiKey, baseUrl)
 
+    registerTool(tasksListCompleted, server, todoist)
     registerTool(tasksListByDate, server, todoist)
     registerTool(tasksListOverdue, server, todoist)
     registerTool(tasksListForProject, server, todoist)

src/tools/tasks-list-completed.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod'
+import type { TodoistTool } from '../todoist-tool'
+import { mapTask } from './shared'
+
+const ArgsSchema = {
+    getBy: z
+        .enum(['completion', 'due'])
+        .default('completion')
+        .describe(
+            'The method to use to get the tasks: "completion" to get tasks by completion date (ie, when the task was actually completed), "due" to get tasks by due date (ie, when the task was due to be completed by).',
+        ),
+    since: z
+        .string()
+        .date()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe('The start date to get the tasks for. Format: YYYY-MM-DD.'),
+    until: z
+        .string()
+        .date()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe('The start date to get the tasks for. Format: YYYY-MM-DD.'),
+    workspaceId: z.string().optional().describe('The ID of the workspace to get the tasks for.'),
+    projectId: z.string().optional().describe('The ID of the project to get the tasks for.'),
+    sectionId: z.string().optional().describe('The ID of the section to get the tasks for.'),
+    parentId: z.string().optional().describe('The ID of the parent task to get the tasks for.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .describe('The maximum number of tasks to return. Default is 50, maximum is 200.'),
+    cursor: z
+        .string()
+        .optional()
+        .describe(
+            'The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).',
+        ),
+}
+
+const tasksListCompleted = {
+    name: 'tasks-list-completed',
+    description: 'Get completed tasks.',
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { getBy, ...rest } = args
+        const { items, nextCursor } =
+            getBy === 'completion'
+                ? await client.getCompletedTasksByCompletionDate(rest)
+                : await client.getCompletedTasksByDueDate(rest)
+        return {
+            tasks: items.map(mapTask),
+            nextCursor,
+        }
+    },
+} satisfies TodoistTool<typeof ArgsSchema>
+
+export { tasksListCompleted }