Skip to main content

​
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.
⌘I