Skip to main content Accueil Créateurs luokai0 ai-agent-skills-by-luo-kai google-tasks
google-tasks Google Tasks API integration with managed OAuth. Manage task lists and tasks with full CRUD operations.
Use this skill when users want to read, create, update, or delete tasks and task lists in Google Tasks.
For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Aller à l'installation Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/luokai0/ai-agent-skills-by-luo-kai --skill google-tasksLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Plus depuis ce dépôt writers-room-story-engine Writers Room Story Engine mega-skill. Creates, structures, drafts, and revises compelling standalone stories from zero using premise generation, audience engagement, thematic design, character arcs, Story Spine structure, causal beats, worldbuilding in service of story, scene construction, and revision diagnostics. Use when developing short stories, standalone fiction, scripts, or narrative concepts from scratch or when improving weak drafts.
Browse Airtable bases and tables, inspect records, create records, and manage fields, comments, and table actions — powered by ClawLink.
Alibaba Cloud DNS (Alidns) CLI skill. Use to query, add, and update DNS records via aliyun-cli, including CNAME setup for Function Compute custom domains.
Métiers associés SOC
Basé sur la classification professionnelle SOC
name google-tasks description Google Tasks API integration with managed OAuth. Manage task lists and tasks with full CRUD operations.
Use this skill when users want to read, create, update, or delete tasks and task lists in Google Tasks.
For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility Requires network access and valid Maton API key metadata {"author":"maton","version":"1.0","clawdbot":{"emoji":"🧠","requires":{"env":["MATON_API_KEY"]}}}
Google Tasks
Access the Google Tasks API with managed OAuth authentication. Manage task lists and tasks with full CRUD operations.
Quick Start
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/google-tasks/tasks/v1/users/@me/lists' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Base URL
https://api.maton.ai/google-tasks/{native-api-path}
Maton proxies requests to tasks.googleapis.com and automatically injects your OAuth token.
Authentication
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as MATON_API_KEY:
export MATON_API_KEY="YOUR_API_KEY"
Getting Your API Key
Connection Management Manage your Google Tasks OAuth connections at https://api.maton.ai.
List Connections python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=google-tasks&status=ACTIVE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Create Connection python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app' : 'google-tasks' }).encode()
req = urllib.request.Request('https://api.maton.ai/connections' , data=data, method='POST' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
req.add_header('Content-Type' , 'application/json' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Get Connection python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"connection" : {
"connection_id" : "{connection_id}" ,
"status" : "ACTIVE" ,
"creation_time" : "2026-02-07T02:35:51.002199Z" ,
"last_updated_time" : "2026-02-07T05:32:30.369186Z" ,
"url" : "https://connect.maton.ai/?session_token=..." ,
"app" : "google-tasks" ,
"metadata" : { }
}
}
Open the returned url in a browser to complete OAuth authorization.
Delete Connection python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}' , method='DELETE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Specifying Connection If you have multiple Google Tasks connections, specify which one to use with the Maton-Connection header:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/google-tasks/tasks/v1/users/@me/lists' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
req.add_header('Maton-Connection' , '{connection_id}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
If you have multiple connections, always include this header to ensure requests go to the intended account.
Security & Permissions
Access is scoped to task lists and tasks with full CRUD operations within the connected Google Tasks account.
All write operations require explicit user approval. Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.
API Reference
Task Lists
List All Task Lists GET /google-tasks/tasks/v1/users/@me/lists
maxResults - Maximum number of task lists to return (default: 20, max: 100)pageToken - Token for pagination {
"kind" : "tasks#taskLists" ,
"etag" : "\"OW7pv01-vgQ\"" ,
"items" : [
{
"kind" : "tasks#taskList" ,
"id" : "MDEzMTQ2ODk4NDc2ODkyOTIyMTE6MDow" ,
"etag" : "\"Yz7ljQZ5Xuw\"" ,
"title" : "My Tasks" ,
"updated" : "2023-09-18T06:12:59.468Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/users/@me/lists/MDEzMTQ2ODk4NDc2ODkyOTIyMTE6MDow"
}
]
}
Get Task List GET /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Create Task List POST /google-tasks/tasks/v1/users/@me/lists
Content-Type: application/json
{
"title" : "New Task List"
}
{
"kind" : "tasks#taskList" ,
"id" : "OFYyU09veWMyWl84SjNQXw" ,
"etag" : "\"XTqLSxP4QZQ\"" ,
"title" : "New Task List" ,
"updated" : "2026-02-07T05:45:22.685Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/users/@me/lists/OFYyU09veWMyWl84SjNQXw"
}
Update Task List (PATCH - partial update) PATCH /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Content-Type: application/json
{
"title" : "Updated Title"
}
Update Task List (PUT - full replace) PUT /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Content-Type: application/json
{
"title" : "Replaced Title"
}
Delete Task List DELETE /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Tasks
List Tasks GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks
maxResults - Maximum number of tasks to return (default: 20, max: 100)pageToken - Token for paginationshowCompleted - Include completed tasks (default: true)showDeleted - Include deleted tasks (default: false)showHidden - Include hidden tasks (default: false)dueMin - Lower bound for due date (RFC 3339 timestamp)dueMax - Upper bound for due date (RFC 3339 timestamp)completedMin - Lower bound for completion date (RFC 3339 timestamp)completedMax - Upper bound for completion date (RFC 3339 timestamp)updatedMin - Lower bound for last update time (RFC 3339 timestamp) {
"kind" : "tasks#tasks" ,
"etag" : "\"Jhh35adkRkU\"" ,
"nextPageToken" : "CgwI27nR6AUQsKHh7QIa..." ,
"items" : [
{
"kind" : "tasks#task" ,
"id" : "blJQR1hfaXhSU0tMY3gwdg" ,
"etag" : "\"Uqc8Y3T9VOA\"" ,
"title" : "Example Task" ,
"updated" : "2020-11-09T21:17:08.911Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/lists/.../tasks/blJQR1hfaXhSU0tMY3gwdg" ,
"position" : "00000000000000000000" ,
"status" : "needsAction" ,
"due" : "2020-12-08T00:00:00.000Z" ,
"notes" : "Task notes here" ,
"links" : [ ] ,
"webViewLink" : "https://tasks.google.com/task/nRPGX_ixRSKLcx0v?sa=6"
}
]
}
Get Task GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Create Task POST /google-tasks/tasks/v1/lists/{tasklistId}/tasks
Content-Type: application/json
{
"title" : "New Task" ,
"notes" : "Task description" ,
"due" : "2026-03-01T00:00:00.000Z"
}
Query Parameters (optional):
parent - Parent task ID (for subtasks)previous - Previous sibling task ID (for positioning) {
"kind" : "tasks#task" ,
"id" : "bkludnJmdjZIZWVFejBnYg" ,
"etag" : "\"EKX4SVb-Ljk\"" ,
"title" : "New Task" ,
"updated" : "2026-02-07T05:45:05.371Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/lists/.../tasks/bkludnJmdjZIZWVFejBnYg" ,
"position" : "00000000000000000000" ,
"notes" : "Task description" ,
"status" : "needsAction" ,
"due" : "2026-03-01T00:00:00.000Z" ,
"links" : [ ] ,
"webViewLink" : "https://tasks.google.com/task/nInvrfv6HeeEz0gb?sa=6"
}
Update Task (PATCH - partial update) PATCH /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Content-Type: application/json
{
"title" : "Updated Task Title" ,
"status" : "completed"
}
{
"kind" : "tasks#task" ,
"id" : "bkludnJmdjZIZWVFejBnYg" ,
"etag" : "\"OeWHIDNj-os\"" ,
"title" : "Updated Task Title" ,
"updated" : "2026-02-07T05:45:15.334Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/lists/.../tasks/bkludnJmdjZIZWVFejBnYg" ,
"position" : "00000000000000000000" ,
"notes" : "Task description" ,
"status" : "completed" ,
"completed" : "2026-02-07T05:45:15.307Z" ,
"links" : [ ] ,
"webViewLink" : "https://tasks.google.com/task/nInvrfv6HeeEz0gb?sa=6"
}
Update Task (PUT - full replace) PUT /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Content-Type: application/json
{
"title" : "Replaced Task" ,
"notes" : "New notes" ,
"status" : "needsAction"
}
Delete Task DELETE /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Move Task Reposition a task within a task list or change its parent.
POST /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}/move
Query Parameters (optional):
parent - New parent task ID (for making it a subtask)previous - Previous sibling task ID (for positioning after this task) {
"kind" : "tasks#task" ,
"id" : "VkI5bTEzazdvNzlYNWVycw" ,
"etag" : "\"Uplv6eL0sDo\"" ,
"title" : "Task B" ,
"updated" : "2026-02-07T05:45:36.801Z" ,
"selfLink" : "https://www.googleapis.com/tasks/v1/lists/.../tasks/VkI5bTEzazdvNzlYNWVycw" ,
"position" : "00000000000000000001" ,
"status" : "needsAction" ,
"links" : [ ] ,
"webViewLink" : "https://tasks.google.com/task/VB9m13k7o79X5ers?sa=6"
}
Clear Completed Tasks Delete all completed tasks from a task list.
POST /google-tasks/tasks/v1/lists/{tasklistId}/clear
Returns HTTP 204 No Content on success.
Task Resource Fields Field Type Description kindstring Always "tasks#task" (output only) idstring Task identifier etagstring ETag of the resource titlestring Task title (max 1024 characters) updatedstring Last modification time (RFC 3339, output only) selfLinkstring URL to this task (output only) parentstring Parent task ID (output only) positionstring Position among siblings (output only) notesstring Task notes (max 8192 characters) statusstring "needsAction" or "completed" duestring Due date (RFC 3339 timestamp) completedstring Completion date (RFC 3339, output only) deletedboolean Whether task is deleted hiddenboolean Whether task is hidden linksarray Collection of links (output only) webViewLinkstring Link to task in Google Tasks UI (output only)
Task List Resource Fields Field Type Description kindstring Always "tasks#taskList" (output only) idstring Task list identifier etagstring ETag of the resource titlestring Task list title (max 1024 characters) updatedstring Last modification time (RFC 3339, output only) selfLinkstring URL to this task list (output only)
Pagination Use maxResults and pageToken for pagination:
GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks?maxResults=50
Response includes nextPageToken when more results exist:
{
"kind" : "tasks#tasks" ,
"etag" : "..." ,
"nextPageToken" : "CgwI27nR6AUQsKHh7QIa..." ,
"items" : [ ...]
}
Use the nextPageToken value in subsequent requests:
GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks?maxResults=50&pageToken=CgwI27nR6AUQsKHh7QIa...
Code Examples
JavaScript
const response = await fetch (
'https://api.maton.ai/google-tasks/tasks/v1/users/@me/lists' ,
{
headers : {
'Authorization' : `Bearer ${process.env.MATON_API_KEY} `
}
}
);
const createResponse = await fetch (
`https://api.maton.ai/google-tasks/tasks/v1/lists/${tasklistId} /tasks` ,
{
method : 'POST' ,
headers : {
'Authorization' : `Bearer ${process.env.MATON_API_KEY} ` ,
'Content-Type' : 'application/json'
},
body : JSON .stringify ({
title : 'New Task' ,
notes : 'Task description' ,
due : '2026-03-01T00:00:00.000Z'
})
}
);
Python import os
import requests
response = requests.get(
'https://api.maton.ai/google-tasks/tasks/v1/users/@me/lists' ,
headers={'Authorization' : f'Bearer {os.environ["MATON_API_KEY" ]} ' }
)
create_response = requests.post(
f'https://api.maton.ai/google-tasks/tasks/v1/lists/{tasklist_id} /tasks' ,
headers={'Authorization' : f'Bearer {os.environ["MATON_API_KEY" ]} ' },
json={
'title' : 'New Task' ,
'notes' : 'Task description' ,
'due' : '2026-03-01T00:00:00.000Z'
}
)
Notes
Task list IDs and task IDs are opaque strings (base64-encoded)
Status values are "needsAction" or "completed"
Due dates are RFC 3339 timestamps
Maximum title length: 1024 characters
Maximum notes length: 8192 characters
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.
Error Handling Status Meaning 400 Missing Google Tasks connection 401 Invalid or missing Maton API key 404 Task or task list not found 429 Rate limited 4xx/5xx Passthrough error from Google Tasks API
Troubleshooting: API Key Issues
Check that the MATON_API_KEY environment variable is set:
Verify the API key is valid by listing connections:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Troubleshooting: Invalid App Name
Ensure your URL path starts with google-tasks. For example:
Correct: https://api.maton.ai/google-tasks/tasks/v1/users/@me/lists
Incorrect: https://api.maton.ai/tasks/v1/users/@me/lists
Resources 