Google Task Guide

​

What can you do with it?

Google Task allows you to manage task lists and individual tasks programmatically. You can create, read, update, and delete task lists, add tasks with due dates and notes, organize tasks into subtasks, mark tasks as completed, and clear completed tasks. This integration is perfect for task management workflows, to-do list automation, and project organization.

​

How to use it?

​

Basic Command Structure

/your-Google-Task-connection [action] [required-parameters] [optional-parameters]

​

Parameters

Required:

• action - The operation to perform on task lists or tasks

​

Tools

​

List All Task Lists

Get all task lists for the authenticated user

Parameters:

• None required

Example:

/your-Google-Task-connection
action: list-tasklists

Response:

{
  "items": [
    {
      "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA",
      "title": "My Tasks",
      "updated": "2023-07-15T10:30:22.000Z"
    }
  ]
}

​

Create Task List

Create a new task list

Parameters:

• title (required) - Name of the new task list

Example:

/your-Google-Task-connection
action: create-tasklist
title: Home Renovation

Response:

{
  "id": "OTAxMjM0NTY3ODkwMTIzNDU2Nzg5",
  "title": "Home Renovation",
  "updated": "2025-03-08T09:15:32.000Z"
}

​

Update Task List

Update an existing task list

Parameters:

• tasklist-id (required) - The ID of the task list to update
• title (required) - New title for the task list

Example:

/your-Google-Task-connection
action: update-tasklist
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
title: Home Renovation 2025

Response:

{
  "id": "OTAxMjM0NTY3ODkwMTIzNDU2Nzg5",
  "title": "Home Renovation 2025",
  "updated": "2025-03-08T09:25:45.000Z"
}

​

Delete Task List

Delete a task list

Parameters:

• tasklist-id (required) - The ID of the task list to delete

Example:

/your-Google-Task-connection
action: delete-tasklist
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5

Response:

{
  "status": "deleted"
}

​

List Tasks

Get all tasks in a specific task list

Parameters:

• tasklist-id (required) - The ID of the task list
• show-completed (optional) - Include completed tasks (default: false)
• show-hidden (optional) - Include hidden tasks (default: false)

Example:

/your-Google-Task-connection
action: list-tasks
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
show-completed: true

Response:

{
  "items": [
    {
      "id": "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
      "title": "Buy paint",
      "status": "needsAction",
      "due": "2025-03-15T00:00:00.000Z"
    }
  ]
}

​

Create Task

Create a new task in a task list

Parameters:

• tasklist-id (required) - The ID of the task list
• title (required) - Title of the task
• notes (optional) - Additional notes for the task
• due (optional) - Due date in ISO format
• parent (optional) - Parent task ID to create a subtask

Example:

/your-Google-Task-connection
action: create-task
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
title: Purchase tiles
notes: Ceramic tiles for bathroom floor - 20 sq ft
due: 2025-03-20T00:00:00.000Z

Response:

{
  "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM",
  "title": "Purchase tiles",
  "notes": "Ceramic tiles for bathroom floor - 20 sq ft",
  "status": "needsAction",
  "due": "2025-03-20T00:00:00.000Z"
}

​

Update Task

Update an existing task

Parameters:

• tasklist-id (required) - The ID of the task list
• task-id (required) - The ID of the task to update
• title (optional) - New title for the task
• notes (optional) - Updated notes
• due (optional) - New due date
• status (optional) - Task status (“needsAction” or “completed”)

Example:

/your-Google-Task-connection
action: update-task
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
task-id: MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI
title: Buy premium paint
status: completed

Response:

{
  "id": "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
  "title": "Buy premium paint",
  "status": "completed",
  "completed": "2025-03-08T09:45:22.000Z"
}

​

Move Task

Move a task to a different position or make it a subtask

Parameters:

• tasklist-id (required) - The ID of the task list
• task-id (required) - The ID of the task to move
• previous (optional) - ID of the task that should come before this task
• parent (optional) - ID of the parent task to make this a subtask

Example:

/your-Google-Task-connection
action: move-task
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
task-id: MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI
parent: MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM

Response:

{
  "id": "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
  "title": "Buy premium paint",
  "parent": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM",
  "position": "00000000000000000002"
}

​

Delete Task

Delete a specific task

Parameters:

• tasklist-id (required) - The ID of the task list
• task-id (required) - The ID of the task to delete

Example:

/your-Google-Task-connection
action: delete-task
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5
task-id: MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI

Response:

{
  "status": "deleted"
}

​

Clear Completed Tasks

Remove all completed tasks from a task list

Parameters:

• tasklist-id (required) - The ID of the task list

Example:

/your-Google-Task-connection
action: clear-completed
tasklist-id: OTAxMjM0NTY3ODkwMTIzNDU2Nzg5

Response:

{
  "status": "cleared"
}

​

Notes

Task list IDs can be extracted from Google Tasks URLs using the pattern: tasklistid=[TASK_LIST_ID]. Due dates should be provided in ISO 8601 format. Tasks can be organized hierarchically using parent-child relationships. The status field accepts “needsAction” for pending tasks and “completed” for finished tasks.