Google MCP

Instructions

Implementation Reference

• handlers/tasks.ts:59-72 (handler)

  Main handler function for 'google_tasks_get_task' tool. Validates input arguments, extracts taskId and taskListId, calls the GoogleTasks instance's getTask method, and formats the response.

  export async function handleTasksGetTask(
    args: any,
    googleTasksInstance: GoogleTasks
  ) {
    if (!isGetTaskArgs(args)) {
      throw new Error("Invalid arguments for google_tasks_get_task");
    }
    const { taskId, taskListId } = args;
    const result = await googleTasksInstance.getTask(taskId, taskListId);
    return {
      content: [{ type: "text", text: result }],
      isError: false,
    };
  }

• tools/tasks/index.ts:46-64 (schema)

  Tool definition including name, description, and inputSchema for 'google_tasks_get_task'.

  export const GET_TASK_TOOL: Tool = {
    name: "google_tasks_get_task",
    description: "Get details about a specific task",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "string",
          description: "ID of the task to retrieve",
        },
        taskListId: {
          type: "string",
          description:
            "ID of the task list the task belongs to (uses default if not specified)",
        },
      },
      required: ["taskId"],
    },
  };

• server-setup.ts:228-232 (registration)

  Registration in the switch statement that dispatches tool calls to the specific handler function.

  case "google_tasks_get_task":
    return await tasksHandlers.handleTasksGetTask(
      args,
      googleTasksInstance
    );

• utils/helper.ts:339-348 (helper)

  Type guard function used for input validation in the handler (isGetTaskArgs).

  export function isGetTaskArgs(args: any): args is {
    taskId: string;
    taskListId?: string;
  } {
    return (
      args &&
      typeof args.taskId === "string" &&
      (args.taskListId === undefined || typeof args.taskListId === "string")
    );
  }

• utils/tasks.ts:79-107 (helper)

  Core implementation in GoogleTasks class: fetches the task using Google API, formats the output with title, ID, status, due date, completion date, and notes.

    async getTask(taskId: string, taskListId?: string) {
      try {
        const targetTaskList = taskListId || this.defaultTaskList;
        const response = await this.tasks.tasks.get({
          tasklist: targetTaskList,
          task: taskId,
        });
  
        const task = response.data;
        const due = task.due ? `Due: ${new Date(task.due).toLocaleString()}` : "";
        const completed = task.completed
          ? `Completed: ${new Date(task.completed).toLocaleString()}`
          : "";
        const status = task.status || "";
  
        return `Task: ${task.title}
  ID: ${task.id}
  Status: ${status}
  ${due}
  ${completed}
  ${task.notes ? `Notes: ${task.notes}` : ""}`;
      } catch (error) {
        throw new Error(
          `Failed to get task: ${
            error instanceof Error ? error.message : String(error)
          }`
        );
      }
    }