google_tasks_update_task

Instructions

Implementation Reference

• handlers/tasks.ts:94-111 (handler)

  The handler function that validates the input arguments using isUpdateTaskArgs and calls the GoogleTasks.updateTask method to perform the update.

  export async function handleTasksUpdateTask(
    args: any,
    googleTasksInstance: GoogleTasks
  ) {
    if (!isUpdateTaskArgs(args)) {
      throw new Error("Invalid arguments for google_tasks_update_task");
    }
    const { taskId, title, notes, due, status, taskListId } = args;
    const result = await googleTasksInstance.updateTask(
      taskId,
      { title, notes, due, status },
      taskListId
    );
    return {
      content: [{ type: "text", text: result }],
      isError: false,
    };
  }

• tools/tasks/index.ts:95-129 (schema)

  The MCP tool schema defining the name, description, and input schema for google_tasks_update_task.

  export const UPDATE_TASK_TOOL: Tool = {
    name: "google_tasks_update_task",
    description: "Update an existing task",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "string",
          description: "ID of the task to update",
        },
        title: {
          type: "string",
          description: "New title for the task",
        },
        notes: {
          type: "string",
          description: "New notes or description for the task",
        },
        due: {
          type: "string",
          description: "New due date in RFC 3339 format",
        },
        status: {
          type: "string",
          description: "New status for the task (needsAction or completed)",
        },
        taskListId: {
          type: "string",
          description:
            "ID of the task list the task belongs to (uses default if not specified)",
        },
      },
      required: ["taskId"],
    },
  };

• server-setup.ts:238-242 (registration)

  The dispatch case in the main tool call handler that routes google_tasks_update_task calls to the tasks handler.

  case "google_tasks_update_task":
    return await tasksHandlers.handleTasksUpdateTask(
      args,
      googleTasksInstance
    );

• utils/helper.ts:365-382 (helper)

  Type guard (schema validation helper) used in the handler to validate arguments for google_tasks_update_task.

  export function isUpdateTaskArgs(args: any): args is {
    taskId: string;
    title?: string;
    notes?: string;
    due?: string;
    status?: string;
    taskListId?: string;
  } {
    return (
      args &&
      typeof args.taskId === "string" &&
      (args.title === undefined || typeof args.title === "string") &&
      (args.notes === undefined || typeof args.notes === "string") &&
      (args.due === undefined || typeof args.due === "string") &&
      (args.status === undefined || typeof args.status === "string") &&
      (args.taskListId === undefined || typeof args.taskListId === "string")
    );
  }

• utils/tasks.ts:141-182 (helper)

  The core Google Tasks API implementation for updating a task, called by the handler. Fetches current task, merges updates, and performs the API patch.

  async updateTask(
    taskId: string,
    data: {
      title?: string;
      notes?: string;
      due?: string;
      status?: string;
    },
    taskListId?: string
  ) {
    try {
      const targetTaskList = taskListId || this.defaultTaskList;
  
      // Get current task data
      const currentTask = await this.tasks.tasks.get({
        tasklist: targetTaskList,
        task: taskId,
      });
  
      // Prepare updated task data
      const updatedTask = { ...currentTask.data };
  
      if (data.title !== undefined) updatedTask.title = data.title;
      if (data.notes !== undefined) updatedTask.notes = data.notes;
      if (data.due !== undefined) updatedTask.due = data.due;
      if (data.status !== undefined) updatedTask.status = data.status;
  
      const response = await this.tasks.tasks.update({
        tasklist: targetTaskList,
        task: taskId,
        requestBody: updatedTask,
      });
  
      return `Task updated: "${response.data.title}" with ID: ${response.data.id}`;
    } catch (error) {
      throw new Error(
        `Failed to update task: ${
          error instanceof Error ? error.message : String(error)
        }`
      );
    }
  }