google_tasks_create_task
Create and manage tasks within Google Tasks by specifying a title, notes, due date, and task list. Integrates with Google MCP for AI-driven task management workflows.
Instructions
Create a new task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | No | Due date in RFC 3339 format (e.g., '2025-04-02T10:00:00.000Z') | |
| notes | No | Notes or description for the task | |
| taskListId | No | ID of the task list to create the task in (uses default if not specified) | |
| title | Yes | Title of the task |
Implementation Reference
- handlers/tasks.ts:74-92 (handler)Handler function that validates input arguments and delegates to GoogleTasks.createTask to create a new task.
export async function handleTasksCreateTask( args: any, googleTasksInstance: GoogleTasks ) { if (!isCreateTaskArgs(args)) { throw new Error("Invalid arguments for google_tasks_create_task"); } const { title, notes, due, taskListId } = args; const result = await googleTasksInstance.createTask( title, notes, due, taskListId ); return { content: [{ type: "text", text: result }], isError: false, }; } - utils/tasks.ts:109-139 (helper)Implements the task creation using Google Tasks API v1, inserting a new task into the specified tasklist.
async createTask( title: string, notes?: string, due?: string, taskListId?: string ) { try { const targetTaskList = taskListId || this.defaultTaskList; // Prepare task data const taskData: any = { title: title, }; if (notes) taskData.notes = notes; if (due) taskData.due = due; const response = await this.tasks.tasks.insert({ tasklist: targetTaskList, requestBody: taskData, }); return `Task created: "${response.data.title}" with ID: ${response.data.id}`; } catch (error) { throw new Error( `Failed to create task: ${ error instanceof Error ? error.message : String(error) }` ); } } - tools/tasks/index.ts:66-93 (schema)MCP Tool definition including name, description, and input schema for creating a task.
export const CREATE_TASK_TOOL: Tool = { name: "google_tasks_create_task", description: "Create a new task", inputSchema: { type: "object", properties: { title: { type: "string", description: "Title of the task", }, notes: { type: "string", description: "Notes or description for the task", }, due: { type: "string", description: "Due date in RFC 3339 format (e.g., '2025-04-02T10:00:00.000Z')", }, taskListId: { type: "string", description: "ID of the task list to create the task in (uses default if not specified)", }, }, required: ["title"], }, }; - server-setup.ts:233-237 (registration)Dispatches tool calls named 'google_tasks_create_task' to the corresponding handler function.
case "google_tasks_create_task": return await tasksHandlers.handleTasksCreateTask( args, googleTasksInstance ); - utils/helper.ts:350-363 (helper)Type guard function used in the handler to validate input arguments against the expected schema.
export function isCreateTaskArgs(args: any): args is { title: string; notes?: string; due?: string; taskListId?: string; } { return ( args && typeof args.title === "string" && (args.notes === undefined || typeof args.notes === "string") && (args.due === undefined || typeof args.due === "string") && (args.taskListId === undefined || typeof args.taskListId === "string") ); }