
Google Tasks
Available ActionsEach successful request consumes credits as outlined below.
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-setupcurl -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
Manage credentials in your dashboard.
Actions(19)
list_tasklists5cr2 paramsList all task lists in the user's account.
list_tasklists5cr2 paramsList all task lists in the user's account.
max_resultsintegerMaximum number of items to return (1-100)
100page_tokenstringPage token for pagination
get_tasklist5cr1 param(1 required)Get details of a specific task list.
get_tasklist5cr1 param(1 required)Get details of a specific task list.
tasklist_idrequiredstringTask list ID
create_tasklist5cr1 param(1 required)Create a new task list.
create_tasklist5cr1 param(1 required)Create a new task list.
tasklist_titlerequiredstringTitle for the new task list. You can also use 'title' as a shorthand.
update_tasklist5cr2 params(2 required)Fully update a task list (replaces existing data).
update_tasklist5cr2 params(2 required)Fully update a task list (replaces existing data).
tasklist_idrequiredstringTask list ID
tasklist_titlerequiredstringNew title for the task list. You can also use 'title' as a shorthand.
delete_tasklist5cr1 param(1 required)Delete a task list.
delete_tasklist5cr1 param(1 required)Delete a task list.
tasklist_idrequiredstringTask list ID
patch_tasklist5cr2 params(2 required)Partially update a task list title.
patch_tasklist5cr2 params(2 required)Partially update a task list title.
tasklist_idrequiredstringTask list ID
tasklist_titlerequiredstringNew title for the task list. You can also use 'title' as a shorthand.
list_tasks5cr11 paramsList tasks in a specific task list.
list_tasks5cr11 paramsList tasks in a specific task list.
tasklist_idstringTask list ID. Defaults to '@default' (primary list) if omitted
max_resultsintegerMaximum number of items to return (1-100)
100page_tokenstringPage token for pagination
show_completedbooleanWhether to show completed tasks
trueshow_deletedbooleanWhether to show deleted tasks
falseshow_hiddenbooleanWhether to show hidden tasks
falseupdated_minstringLower bound for task's last modification time (RFC 3339)
completed_minstringLower bound for task's completion date (RFC 3339)
completed_maxstringUpper bound for task's completion date (RFC 3339)
due_minstringLower bound for task's due date (RFC 3339)
due_maxstringUpper bound for task's due date (RFC 3339)
get_task5cr2 params(1 required)Get details of a specific task.
get_task5cr2 params(1 required)Get details of a specific task.
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
create_task5cr7 params(1 required)Create a new task in a task list.
create_task5cr7 params(1 required)Create a new task in a task list.
titlerequiredstringTask title
tasklist_idstringTask list ID. Defaults to '@default' if omitted
notesstringTask notes/description
duestringDue date in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ)
statusstringTask status
parentstringParent task ID for creating subtasks
previousstringPrevious task ID for positioning
update_task5cr6 params(1 required)Fully update a task (merges with existing data).
update_task5cr6 params(1 required)Fully update a task (merges with existing data).
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
titlestringTask title
notesstringTask notes/description
duestringDue date in ISO 8601 format
statusstringTask status
delete_task5cr2 params(1 required)Delete a task.
delete_task5cr2 params(1 required)Delete a task.
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
patch_task5cr6 params(1 required)Partially update specific fields of a task.
patch_task5cr6 params(1 required)Partially update specific fields of a task.
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
titlestringTask title
notesstringTask notes/description
duestringDue date in ISO 8601 format
statusstringTask status
move_task5cr4 params(1 required)Move a task within a list (reorder or nest under a parent).
move_task5cr4 params(1 required)Move a task within a list (reorder or nest under a parent).
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
parentstringParent task ID to nest under
previousstringPrevious task ID to position after
clear_completed5cr1 paramRemove all completed tasks from a task list.
clear_completed5cr1 paramRemove all completed tasks from a task list.
tasklist_idstringTask list ID. Defaults to '@default' if omitted
complete_task5cr2 params(1 required)Mark a task as completed.
complete_task5cr2 params(1 required)Mark a task as completed.
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
uncomplete_task5cr2 params(1 required)Mark a completed task as incomplete.
uncomplete_task5cr2 params(1 required)Mark a completed task as incomplete.
task_idrequiredstringTask ID
tasklist_idstringTask list ID. Defaults to '@default' if omitted
batch_create_tasks5cr2 params(1 required)Create multiple tasks at once in a task list.
batch_create_tasks5cr2 params(1 required)Create multiple tasks at once in a task list.
tasksrequiredarrayArray of task objects to create
tasklist_idstringTask list ID. Defaults to '@default' if omitted
get_all_tasks5cr3 paramsRetrieve all tasks across all task lists.
get_all_tasks5cr3 paramsRetrieve all tasks across all task lists.
show_completedbooleanWhether to show completed tasks
trueshow_deletedbooleanWhether to show deleted tasks
falseshow_hiddenbooleanWhether to show hidden tasks
falsesearch_tasks5cr2 params(1 required)Search for tasks by keyword across all task lists. Matches against task titles and notes.
search_tasks5cr2 params(1 required)Search for tasks by keyword across all task lists. Matches against task titles and notes.
search_queryrequiredstringSearch query for finding tasks
show_completedbooleanWhether to include completed tasks in search results
trueUsage 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 acceptstitle
{"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 acceptstitle
{"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 acceptstitle
{"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 withtitle; optionalnotes,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_taskwith justtitleto add to the default list. - Project setup: Use
create_tasklistthenbatch_create_tasksto set up a project with multiple tasks. - Daily review: Use
list_taskswithshow_completed: falseto see pending items, orget_all_tasksfor a full overview. - Find a task: Use
search_tasksto locate tasks by keyword across all lists. - Task completion: Use
complete_task/uncomplete_taskfor simple status toggling. - Cleanup: Use
clear_completedto remove finished tasks from a list.
Important Notes
- Use
@defaultfortasklist_idto target the user's primary task list. If omitted, most task actions default to@default. - Due dates accept
YYYY-MM-DDor 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) orcompleted. - Use
patch_taskto update only specific fields without affecting others. Useupdate_taskfor full replacements. - The
parentparameter creates subtasks;previouscontrols ordering within the list. - Pagination: use
page_tokenfrom the response'snext_page_tokento fetch additional pages.
About The Developer

Apoth3osis
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.





