# Google Tasks

## Links

- Product page URL: https://www.agentpmt.com/marketplace/google-tasks
- Product markdown URL: https://www.agentpmt.com/marketplace/google-tasks?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/google-tasks?format=agent-json

## Overview

- Product ID: 6964120f631c056805317a5f
- Vendor: Apoth3osis
- Type: function
- Unit type: request
- Price: 500 credits
- Categories: IoT & Automation, Task Planning & Orchestration, Project Management, Automation, Team Collaboration & Workspaces, Task & Workflow Automation, Agent Memory and Context
- Generated at: 2026-04-15T18:26:49.937Z

### Page Description

Complete Google Tasks management tool enabling AI agents to create read update and delete tasks and task lists. Supports task organization with due dates notes subtasks and completion tracking. Includes batch operations for efficient task management and advanced filtering options for retrieving tasks by date ranges and completion status. Perfect for task automation todo list synchronization project tracking and productivity workflow integration.

### Agent Description

Google Tasks: create, read, update, delete tasks and lists. Due dates, notes, subtasks, completion tracking. Batch operations and filtering.

## Details Tab

### Details

Complete Google Tasks management tool enabling AI agents to create read update and delete tasks and task lists. Supports task organization with due dates notes subtasks and completion tracking. Includes batch operations for efficient task management and advanced filtering options for retrieving tasks by date ranges and completion status. Perfect for task automation todo list synchronization project tracking and productivity workflow integration.

### Actions

- `list_tasklists` (5 credits): List all task lists in the user's account.
- `get_tasklist` (5 credits): Get details of a specific task list.
- `create_tasklist` (5 credits): Create a new task list.
- `update_tasklist` (5 credits): Fully update a task list (replaces existing data).
- `delete_tasklist` (5 credits): Delete a task list.
- `patch_tasklist` (5 credits): Partially update a task list title.
- `list_tasks` (5 credits): List tasks in a specific task list.
- `get_task` (5 credits): Get details of a specific task.
- `create_task` (5 credits): Create a new task in a task list.
- `update_task` (5 credits): Fully update a task (merges with existing data).
- `delete_task` (5 credits): Delete a task.
- `patch_task` (5 credits): Partially update specific fields of a task.
- `move_task` (5 credits): Move a task within a list (reorder or nest under a parent).
- `clear_completed` (5 credits): Remove all completed tasks from a task list.
- `complete_task` (5 credits): Mark a task as completed.
- `uncomplete_task` (5 credits): Mark a completed task as incomplete.
- `batch_create_tasks` (5 credits): Create multiple tasks at once in a task list.
- `get_all_tasks` (5 credits): Retrieve all tasks across all task lists.
- `search_tasks` (5 credits): Search for tasks by keyword across all task lists. Matches against task titles and notes.

### Use Cases

task management automation, todo list synchronization, project task tracking, deadline monitoring, task completion reporting, productivity workflow integration, calendar task integration, team task distribution, recurring task management, task prioritization

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Advanced Tab

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6964120f631c056805317a5f",
    "parameters": {
      "action": "list_tasklists",
      "max_results": 100
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Credentials

These runtime credentials should be provided under `parameters._credentials` when required.

- Google OAuth (`google_oauth`, oauth_token, required)
  Help: Connect your Google account.
  Connection ID: 69616abea90ed54743f01957

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "list_tasklists": {
      "description": "List all task lists in the user's account.",
      "properties": {
        "max_results": {
          "type": "integer",
          "description": "Maximum number of items to return (1-100)",
          "required": false,
          "default": 100,
          "minimum": 1,
          "maximum": 100
        },
        "page_token": {
          "type": "string",
          "description": "Page token for pagination",
          "required": false
        }
      }
    },
    "get_tasklist": {
      "description": "Get details of a specific task list.",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID",
          "required": true
        }
      }
    },
    "create_tasklist": {
      "description": "Create a new task list.",
      "properties": {
        "tasklist_title": {
          "type": "string",
          "description": "Title for the new task list. You can also use 'title' as a shorthand.",
          "required": true
        }
      }
    },
    "update_tasklist": {
      "description": "Fully update a task list (replaces existing data).",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID",
          "required": true
        },
        "tasklist_title": {
          "type": "string",
          "description": "New title for the task list. You can also use 'title' as a shorthand.",
          "required": true
        }
      }
    },
    "delete_tasklist": {
      "description": "Delete a task list.",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID",
          "required": true
        }
      }
    },
    "patch_tasklist": {
      "description": "Partially update a task list title.",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID",
          "required": true
        },
        "tasklist_title": {
          "type": "string",
          "description": "New title for the task list. You can also use 'title' as a shorthand.",
          "required": true
        }
      }
    },
    "list_tasks": {
      "description": "List tasks in a specific task list.",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' (primary list) if omitted",
          "required": false
        },
        "max_results": {
          "type": "integer",
          "description": "Maximum number of items to return (1-100)",
          "required": false,
          "default": 100,
          "minimum": 1,
          "maximum": 100
        },
        "page_token": {
          "type": "string",
          "description": "Page token for pagination",
          "required": false
        },
        "show_completed": {
          "type": "boolean",
          "description": "Whether to show completed tasks",
          "required": false,
          "default": true
        },
        "show_deleted": {
          "type": "boolean",
          "description": "Whether to show deleted tasks",
          "required": false,
          "default": false
        },
        "show_hidden": {
          "type": "boolean",
          "description": "Whether to show hidden tasks",
          "required": false,
          "default": false
        },
        "updated_min": {
          "type": "string",
          "description": "Lower bound for task's last modification time (RFC 3339)",
          "required": false
        },
        "completed_min": {
          "type": "string",
          "description": "Lower bound for task's completion date (RFC 3339)",
          "required": false
        },
        "completed_max": {
          "type": "string",
          "description": "Upper bound for task's completion date (RFC 3339)",
          "required": false
        },
        "due_min": {
          "type": "string",
          "description": "Lower bound for task's due date (RFC 3339)",
          "required": false
        },
        "due_max": {
          "type": "string",
          "description": "Upper bound for task's due date (RFC 3339)",
          "required": false
        }
      }
    },
    "get_task": {
      "description": "Get details of a specific task.",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "create_task": {
      "description": "Create a new task in a task list.",
      "properties": {
        "title": {
          "type": "string",
          "description": "Task title",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        },
        "notes": {
          "type": "string",
          "description": "Task notes/description",
          "required": false
        },
        "due": {
          "type": "string",
          "description": "Due date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ)",
          "required": false
        },
        "status": {
          "type": "string",
          "description": "Task status",
          "required": false,
          "enum": [
            "needsAction",
            "completed"
          ]
        },
        "parent": {
          "type": "string",
          "description": "Parent task ID for creating subtasks",
          "required": false
        },
        "previous": {
          "type": "string",
          "description": "Previous task ID for positioning",
          "required": false
        }
      }
    },
    "update_task": {
      "description": "Fully update a task (merges with existing data).",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        },
        "title": {
          "type": "string",
          "description": "Task title",
          "required": false
        },
        "notes": {
          "type": "string",
          "description": "Task notes/description",
          "required": false
        },
        "due": {
          "type": "string",
          "description": "Due date in ISO 8601 format",
          "required": false
        },
        "status": {
          "type": "string",
          "description": "Task status",
          "required": false,
          "enum": [
            "needsAction",
            "completed"
          ]
        }
      }
    },
    "delete_task": {
      "description": "Delete a task.",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "patch_task": {
      "description": "Partially update specific fields of a task.",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        },
        "title": {
          "type": "string",
          "description": "Task title",
          "required": false
        },
        "notes": {
          "type": "string",
          "description": "Task notes/description",
          "required": false
        },
        "due": {
          "type": "string",
          "description": "Due date in ISO 8601 format",
          "required": false
        },
        "status": {
          "type": "string",
          "description": "Task status",
          "required": false,
          "enum": [
            "needsAction",
            "completed"
          ]
        }
      }
    },
    "move_task": {
      "description": "Move a task within a list (reorder or nest under a parent).",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        },
        "parent": {
          "type": "string",
          "description": "Parent task ID to nest under",
          "required": false
        },
        "previous": {
          "type": "string",
          "description": "Previous task ID to position after",
          "required": false
        }
      }
    },
    "clear_completed": {
      "description": "Remove all completed tasks from a task list.",
      "properties": {
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "complete_task": {
      "description": "Mark a task as completed.",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "uncomplete_task": {
      "description": "Mark a completed task as incomplete.",
      "properties": {
        "task_id": {
          "type": "string",
          "description": "Task ID",
          "required": true
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "batch_create_tasks": {
      "description": "Create multiple tasks at once in a task list.",
      "properties": {
        "tasks": {
          "type": "array",
          "description": "Array of task objects to create",
          "required": true,
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "description": "Task title"
              },
              "notes": {
                "type": "string",
                "description": "Task notes"
              },
              "due": {
                "type": "string",
                "description": "Due date in ISO 8601 format"
              },
              "status": {
                "type": "string",
                "description": "Task status",
                "enum": [
                  "needsAction",
                  "completed"
                ]
              },
              "parent": {
                "type": "string",
                "description": "Parent task ID"
              },
              "previous": {
                "type": "string",
                "description": "Previous task ID"
              }
            }
          }
        },
        "tasklist_id": {
          "type": "string",
          "description": "Task list ID. Defaults to '@default' if omitted",
          "required": false
        }
      }
    },
    "get_all_tasks": {
      "description": "Retrieve all tasks across all task lists.",
      "properties": {
        "show_completed": {
          "type": "boolean",
          "description": "Whether to show completed tasks",
          "required": false,
          "default": true
        },
        "show_deleted": {
          "type": "boolean",
          "description": "Whether to show deleted tasks",
          "required": false,
          "default": false
        },
        "show_hidden": {
          "type": "boolean",
          "description": "Whether to show hidden tasks",
          "required": false,
          "default": false
        }
      }
    },
    "search_tasks": {
      "description": "Search for tasks by keyword across all task lists. Matches against task titles and notes.",
      "properties": {
        "search_query": {
          "type": "string",
          "description": "Search query for finding tasks",
          "required": true
        },
        "show_completed": {
          "type": "boolean",
          "description": "Whether to include completed tasks in search results",
          "required": false,
          "default": true
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Use 'get_instructions' to retrieve documentation. Action to perform on Google Tasks",
      "required": true,
      "default": "get_instructions",
      "enum": [
        "get_instructions",
        "list_tasklists",
        "get_tasklist",
        "create_tasklist",
        "update_tasklist",
        "delete_tasklist",
        "patch_tasklist",
        "list_tasks",
        "get_task",
        "create_task",
        "update_task",
        "delete_task",
        "patch_task",
        "move_task",
        "clear_completed",
        "complete_task",
        "uncomplete_task",
        "batch_create_tasks",
        "get_all_tasks",
        "search_tasks"
      ]
    },
    "due": {
      "type": "string",
      "description": "Due date in ISO 8601 format",
      "required": false
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of items to return (1-100)",
      "required": false,
      "default": 100,
      "minimum": 1,
      "maximum": 100
    },
    "notes": {
      "type": "string",
      "description": "Task notes/description",
      "required": false
    },
    "search_query": {
      "type": "string",
      "description": "Search query for finding tasks",
      "required": false
    },
    "show_completed": {
      "type": "boolean",
      "description": "Whether to show completed tasks",
      "required": false,
      "default": true
    },
    "status": {
      "type": "string",
      "description": "Task status",
      "required": false,
      "enum": [
        "needsAction",
        "completed"
      ]
    },
    "task_id": {
      "type": "string",
      "description": "Task ID for operations on specific tasks",
      "required": false
    },
    "tasklist_id": {
      "type": "string",
      "description": "Task list ID. Use '@default' for primary list",
      "required": false
    },
    "tasks": {
      "type": "array",
      "description": "List of tasks for batch operations",
      "required": false,
      "items": {
        "type": "object"
      }
    },
    "title": {
      "type": "string",
      "description": "Task title",
      "required": false
    }
  }
}
```

### Usage Instructions

# Google Tasks

Manage task lists and tasks in Google Tasks. Create, update, complete, search, and organize tasks across multiple lists.

## Task List Actions

### list_tasklists
List all task lists in the user's account.

- **Optional:** `max_results` (integer, 1-100, default 100), `page_token` (string)

```json
{"action": "list_tasklists"}
```

### get_tasklist
Get details of a specific task list.

- **Required:** `tasklist_id` (string)

```json
{"action": "get_tasklist", "tasklist_id": "MDk3NTEwMjQ2MzM"}
```

### create_tasklist
Create a new task list.

- **Required:** `tasklist_title` (string) — also accepts `title`

```json
{"action": "create_tasklist", "tasklist_title": "Shopping List"}
```

### update_tasklist
Fully update a task list (replaces existing data).

- **Required:** `tasklist_id` (string), `tasklist_title` (string) — also accepts `title`

```json
{"action": "update_tasklist", "tasklist_id": "MDk3NTEwMjQ2MzM", "tasklist_title": "Grocery List"}
```

### patch_tasklist
Partially update a task list title.

- **Required:** `tasklist_id` (string), `tasklist_title` (string) — also accepts `title`

```json
{"action": "patch_tasklist", "tasklist_id": "MDk3NTEwMjQ2MzM", "tasklist_title": "Renamed List"}
```

### delete_tasklist
Delete a task list.

- **Required:** `tasklist_id` (string)

```json
{"action": "delete_tasklist", "tasklist_id": "MDk3NTEwMjQ2MzM"}
```

## Task Actions

### list_tasks
List tasks in a specific task list.

- **Optional:** `tasklist_id` (string, defaults to primary list `@default`), `max_results` (integer, 1-100, default 100), `page_token` (string), `show_completed` (boolean, default true), `show_deleted` (boolean, default false), `show_hidden` (boolean, default false), `updated_min` (RFC 3339 timestamp), `completed_min` (RFC 3339 timestamp), `completed_max` (RFC 3339 timestamp), `due_min` (RFC 3339 timestamp), `due_max` (RFC 3339 timestamp)

```json
{"action": "list_tasks", "tasklist_id": "@default", "show_completed": false}
```

### get_task
Get details of a specific task.

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{"action": "get_task", "task_id": "abc123", "tasklist_id": "@default"}
```

### create_task
Create a new task.

- **Required:** `title` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`), `notes` (string), `due` (ISO 8601 date: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ), `status` ("needsAction" or "completed"), `parent` (task ID to create as subtask), `previous` (task ID for positioning)

```json
{"action": "create_task", "title": "Buy groceries", "notes": "Milk, eggs, bread", "due": "2026-03-15"}
```

Creating a subtask:
```json
{"action": "create_task", "title": "Buy milk", "parent": "parentTaskId123"}
```

### update_task
Fully update a task (merges with existing data).

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`), `title` (string), `notes` (string), `due` (ISO 8601 date), `status` ("needsAction" or "completed")

```json
{"action": "update_task", "task_id": "abc123", "title": "Updated title", "notes": "New notes", "due": "2026-03-20"}
```

### patch_task
Partially update specific fields of a task.

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`), `title` (string), `notes` (string), `due` (ISO 8601 date), `status` ("needsAction" or "completed")

```json
{"action": "patch_task", "task_id": "abc123", "notes": "Updated notes only"}
```

### delete_task
Delete a task.

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{"action": "delete_task", "task_id": "abc123"}
```

### move_task
Move a task within a list (reorder or nest under a parent).

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`), `parent` (task ID to nest under), `previous` (task ID to position after)

```json
{"action": "move_task", "task_id": "abc123", "parent": "parentTaskId456"}
```

### complete_task
Mark a task as completed.

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{"action": "complete_task", "task_id": "abc123"}
```

### uncomplete_task
Mark a completed task as incomplete.

- **Required:** `task_id` (string)
- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{"action": "uncomplete_task", "task_id": "abc123"}
```

### clear_completed
Remove all completed tasks from a list.

- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{"action": "clear_completed", "tasklist_id": "@default"}
```

## Bulk and Search Actions

### batch_create_tasks
Create multiple tasks at once.

- **Required:** `tasks` (array of task objects, each with `title`; optional `notes`, `due`, `status`, `parent`, `previous`)
- **Optional:** `tasklist_id` (string, defaults to `@default`)

```json
{
  "action": "batch_create_tasks",
  "tasklist_id": "@default",
  "tasks": [
    {"title": "Task 1", "due": "2026-03-15"},
    {"title": "Task 2", "notes": "Details here"},
    {"title": "Task 3", "due": "2026-03-20", "status": "needsAction"}
  ]
}
```

### get_all_tasks
Retrieve all tasks across all task lists.

- **Optional:** `show_completed` (boolean, default true), `show_deleted` (boolean, default false), `show_hidden` (boolean, default false)

```json
{"action": "get_all_tasks", "show_completed": false}
```

### search_tasks
Search for tasks by keyword across all task lists. Matches against task titles and notes.

- **Required:** `search_query` (string)
- **Optional:** `show_completed` (boolean, default true)

```json
{"action": "search_tasks", "search_query": "groceries"}
```

## Common Workflows

1. **Quick task creation:** Use `create_task` with just `title` to add to the default list.
2. **Project setup:** Use `create_tasklist` then `batch_create_tasks` to set up a project with multiple tasks.
3. **Daily review:** Use `list_tasks` with `show_completed: false` to see pending items, or `get_all_tasks` for a full overview.
4. **Find a task:** Use `search_tasks` to locate tasks by keyword across all lists.
5. **Task completion:** Use `complete_task` / `uncomplete_task` for simple status toggling.
6. **Cleanup:** Use `clear_completed` to remove finished tasks from a list.

## Important Notes

- Use `@default` for `tasklist_id` to target the user's primary task list. If omitted, most task actions default to `@default`.
- Due dates accept `YYYY-MM-DD` or full ISO 8601 format (`YYYY-MM-DDTHH:MM:SSZ`).
- Filter timestamps (`updated_min`, `completed_min`, `completed_max`, `due_min`, `due_max`) use RFC 3339 format.
- Task status values are `needsAction` (incomplete) or `completed`.
- Use `patch_task` to update only specific fields without affecting others. Use `update_task` for full replacements.
- The `parent` parameter creates subtasks; `previous` controls ordering within the list.
- Pagination: use `page_token` from the response's `next_page_token` to fetch additional pages.

### About The Developer

- Vendor name: Apoth3osis
- Website: apoth3osis.io

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.