Overview
Add Google Tasks to any ModuleX agent or workflow. Manage tasks and task lists using the Google Tasks REST API (tasks.googleapis.com/tasks/v1).
Categories: Productivity & Collaboration · Task Management · Auth: OAuth2 · Actions: 8
Authentication
OAuth2 Authentication
Connect using Google OAuth (recommended)Required Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Client ID | Google OAuth App Client ID | Yes | xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com |
| Client Secret | Google OAuth App Client Secret | Yes | GOCSPX-xxxxxxxxxxxxxxxxxxxxxxxxxxxx |
OAuth Configuration
- Authorization URL:
https://accounts.google.com/o/oauth2/v2/auth - Token URL:
https://oauth2.googleapis.com/token - Scopes:
https://www.googleapis.com/auth/tasks
Available Actions
create_task — Creates a new task and adds it to the authenticated user's task lists
create_task — Creates a new task and adds it to the authenticated user's task lists
Parameters
string
required
The ID of the task list
string
required
The title of the task
string
The description of the task
boolean
required
Mark as true if your task is already completed
string
Due date of the task as an RFC 3339 timestamp (date portion only)
Response
{
"$defs": {
"TaskItem": {
"additionalProperties": false,
"description": "A Google Tasks task resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Notes"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"due": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"task": {
"anyOf": [
{
"$ref": "#/$defs/TaskItem"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "CreateTaskOutput",
"type": "object"
}
create_task_list — Creates a new task list and adds it to the authenticated user's task lists
create_task_list — Creates a new task list and adds it to the authenticated user's task lists
Parameters
string
required
The title of the task list
Response
{
"$defs": {
"TaskListItem": {
"additionalProperties": false,
"description": "A Google Tasks task list resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskListItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"task_list": {
"anyOf": [
{
"$ref": "#/$defs/TaskListItem"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "CreateTaskListOutput",
"type": "object"
}
delete_task — Deletes the authenticated user's specified task
delete_task — Deletes the authenticated user's specified task
Parameters
string
required
The ID of the task list
string
required
The ID of the task
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"required": [
"success"
],
"title": "DeleteTaskOutput",
"type": "object"
}
delete_task_list — Deletes the authenticated user's specified task list
delete_task_list — Deletes the authenticated user's specified task list
Parameters
string
required
The ID of the task list
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
}
},
"required": [
"success"
],
"title": "DeleteTaskListOutput",
"type": "object"
}
list_tasks — Returns all tasks in the specified task list
list_tasks — Returns all tasks in the specified task list
Parameters
string
required
The ID of the task list
integer
Maximum number of tasks to be fetched (Default:
20)boolean
Whether completed tasks are returned in the result
boolean
Whether deleted tasks are returned in the result
Response
{
"$defs": {
"TaskItem": {
"additionalProperties": false,
"description": "A Google Tasks task resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Notes"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"due": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"tasks": {
"items": {
"$ref": "#/$defs/TaskItem"
},
"title": "Tasks",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListTasksOutput",
"type": "object"
}
list_task_lists — Lists the authenticated user's task lists
list_task_lists — Lists the authenticated user's task lists
Parameters
integer
Maximum number of task lists to be fetched (Default:
20)Response
{
"$defs": {
"TaskListItem": {
"additionalProperties": false,
"description": "A Google Tasks task list resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskListItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"task_lists": {
"items": {
"$ref": "#/$defs/TaskListItem"
},
"title": "Task Lists",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListTaskListsOutput",
"type": "object"
}
update_task — Updates the authenticated user's specified task
update_task — Updates the authenticated user's specified task
Parameters
string
required
The ID of the task list
string
required
The ID of the task
string
required
The title of the task
string
The description of the task
boolean
Mark as true if your task is already completed
string
Due date of the task as an RFC 3339 timestamp (date portion only)
Response
{
"$defs": {
"TaskItem": {
"additionalProperties": false,
"description": "A Google Tasks task resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Notes"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"due": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"task": {
"anyOf": [
{
"$ref": "#/$defs/TaskItem"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "UpdateTaskOutput",
"type": "object"
}
update_task_list — Updates the authenticated user's specified task list
update_task_list — Updates the authenticated user's specified task list
Parameters
string
required
The ID of the task list
string
required
The title of the task list
Response
{
"$defs": {
"TaskListItem": {
"additionalProperties": false,
"description": "A Google Tasks task list resource.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"self_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Self Link"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
}
},
"title": "TaskListItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"task_list": {
"anyOf": [
{
"$ref": "#/$defs/TaskListItem"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "UpdateTaskListOutput",
"type": "object"
}
Limits & Quotas
- Default quota: 50,000 queries per day per project (Google Cloud project-level).
- Per-user rate limit: ~500 requests per 100 seconds.
- Error model: non-2xx responses and timeouts are caught and returned as
success=False+errorrather than raising.