Google Tasks

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

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.

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:6964120f631c056805317a5f
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/6964120f631c056805317a5f/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

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

Usage Instructions

Usage guidance provided directly by the developer for this product.

Google Tasks

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

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.

Google Tasks

Description