Google Tasks by Apoth3osis

Name: Google Tasks
Brand: Apoth3osis
SKU: 6964120f631c056805317a5f
Price: 0.05 USD
Availability: InStock

Google Tasks

Function

Available ActionsEach successful request consumes credits as outlined below.

list_tasklists^5crget_tasklist^5crcreate_tasklist^5crupdate_tasklist^5crdelete_tasklist^5crpatch_tasklist^5crlist_tasks^5crget_task^5crcreate_task^5crupdate_task^5crdelete_task^5crpatch_task^5crmove_task^5crclear_completed^5crcomplete_task^5cruncomplete_task^5crbatch_create_tasks^5crget_all_tasks^5crsearch_tasks^5cr

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.

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

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(19)

list_tasklists^5cr2 params

List all task lists in the user's account.

max_resultsinteger

Maximum number of items to return (1-100)

Default: 100

Range: 1 - 100

page_tokenstring

Page token for pagination

get_tasklist^5cr1 param(1 required)

Get details of a specific task list.

tasklist_idrequiredstring

Task list ID

create_tasklist^5cr1 param(1 required)

Create a new task list.

tasklist_titlerequiredstring

Title for the new task list. You can also use 'title' as a shorthand.

update_tasklist^5cr2 params(2 required)

Fully update a task list (replaces existing data).

tasklist_idrequiredstring

Task list ID

tasklist_titlerequiredstring

New title for the task list. You can also use 'title' as a shorthand.

delete_tasklist^5cr1 param(1 required)

Delete a task list.

tasklist_idrequiredstring

Task list ID

patch_tasklist^5cr2 params(2 required)

Partially update a task list title.

tasklist_idrequiredstring

Task list ID

tasklist_titlerequiredstring

New title for the task list. You can also use 'title' as a shorthand.

list_tasks^5cr11 params

List tasks in a specific task list.

tasklist_idstring

Task list ID. Defaults to '@default' (primary list) if omitted

max_resultsinteger

Maximum number of items to return (1-100)

Default: 100

Range: 1 - 100

page_tokenstring

Page token for pagination

show_completedboolean

Whether to show completed tasks

Default: true

show_deletedboolean

Whether to show deleted tasks

Default: false

show_hiddenboolean

Whether to show hidden tasks

Default: false

updated_minstring

Lower bound for task's last modification time (RFC 3339)

completed_minstring

Lower bound for task's completion date (RFC 3339)

completed_maxstring

Upper bound for task's completion date (RFC 3339)

due_minstring

Lower bound for task's due date (RFC 3339)

due_maxstring

Upper bound for task's due date (RFC 3339)

get_task^5cr2 params(1 required)

Get details of a specific task.

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

create_task^5cr7 params(1 required)

Create a new task in a task list.

titlerequiredstring

Task title

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

notesstring

Task notes/description

duestring

Due date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ)

statusstring

Task status

Values:

needsActioncompleted

parentstring

Parent task ID for creating subtasks

previousstring

Previous task ID for positioning

update_task^5cr6 params(1 required)

Fully update a task (merges with existing data).

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

titlestring

Task title

notesstring

Task notes/description

duestring

Due date in ISO 8601 format

statusstring

Task status

Values:

needsActioncompleted

delete_task^5cr2 params(1 required)

Delete a task.

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

patch_task^5cr6 params(1 required)

Partially update specific fields of a task.

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

titlestring

Task title

notesstring

Task notes/description

duestring

Due date in ISO 8601 format

statusstring

Task status

Values:

needsActioncompleted

move_task^5cr4 params(1 required)

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

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

parentstring

Parent task ID to nest under

previousstring

Previous task ID to position after

clear_completed^5cr1 param

Remove all completed tasks from a task list.

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

complete_task^5cr2 params(1 required)

Mark a task as completed.

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

uncomplete_task^5cr2 params(1 required)

Mark a completed task as incomplete.

task_idrequiredstring

Task ID

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

batch_create_tasks^5cr2 params(1 required)

Create multiple tasks at once in a task list.

tasksrequiredarray

Array of task objects to create

Array of: object

tasklist_idstring

Task list ID. Defaults to '@default' if omitted

get_all_tasks^5cr3 params

Retrieve all tasks across all task lists.

show_completedboolean

Whether to show completed tasks

Default: true

show_deletedboolean

Whether to show deleted tasks

Default: false

show_hiddenboolean

Whether to show hidden tasks

Default: false

search_tasks^5cr2 params(1 required)

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

search_queryrequiredstring

Search query for finding tasks

show_completedboolean

Whether to include completed tasks in search results

Default: true

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

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

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6964120f631c056805317a5f",
    "parameters": {
        "action": "list_tasklists",
        "max_results": 100
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6964120f631c056805317a5f",
  parameters: {
    "action": "list_tasklists",
    "max_results": 100
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6964120f631c056805317a5f",
  parameters: {
    "action": "list_tasklists",
    "max_results": 100
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

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)

{"action": "list_tasklists"}

get_tasklist

Get details of a specific task list.

Required: tasklist_id (string)

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

create_tasklist

Create a new task list.

Required: tasklist_title (string) — also accepts title

{"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

{"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

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

delete_tasklist

Delete a task list.

Required: tasklist_id (string)

{"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)

{"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)

{"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)

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

Creating a subtask:

{"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")

{"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")

{"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)

{"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)

{"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)

{"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)

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

clear_completed

Remove all completed tasks from a list.

Optional: tasklist_id (string, defaults to @default)

{"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)

{
  "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)

{"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)

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

Common Workflows

Quick task creation: Use create_task with just title to add to the default list.
Project setup: Use create_tasklist then batch_create_tasks to set up a project with multiple tasks.
Daily review: Use list_tasks with show_completed: false to see pending items, or get_all_tasks for a full overview.
Find a task: Use search_tasks to locate tasks by keyword across all lists.
Task completion: Use complete_task / uncomplete_task for simple status toggling.
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.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

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

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 6964120f631c056805317a5f ("Google Tasks"). Then call the same tool with action 'call_tool', tool_id 6964120f631c056805317a5f, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Google Tasks

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Credentials

Actions(19)

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.