google_tasks_update_task
Modify task details in Google Tasks, including title, notes, due date, status, or task list, by providing the task ID. Ensures accurate updates for task management.
Instructions
Update an existing task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | No | New due date in RFC 3339 format | |
| notes | No | New notes or description for the task | |
| status | No | New status for the task (needsAction or completed) | |
| taskId | Yes | ID of the task to update | |
| taskListId | No | ID of the task list the task belongs to (uses default if not specified) | |
| title | No | New title for the task |
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) }` ); } }