View as Markdown
Google Tasks icon

Google Tasks ACTION

Search Tasks

Searches tasks across all task lists using a keyword, due date, or both - at least one of Keyword or Due Date must be provided. Keyword matches against both the task title and notes. Completed and deleted tasks are excluded unless Show Completed / Show Deleted are set. Use this action to find tasks that match specific criteria without modifying them. To create, update, complete, or move tasks, use the Create Task, Update Task, Complete Task, or Move Task actions. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Google Tasks account once, then configure and run Search Tasks from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_tasks-search-tasks",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_tasks: { authProvisionId: "apn_xxxxxxx" },
    keyword: "Keyword",
    due: "Due",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Tasks inputs
Property Type Description
keyword Keyword string
Searches task titles and notes for the specified keyword.
Optional
due Due string
Due date of the task (as a RFC 3339 timestamp, for example 2026-07-26T00:00:00Z). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API.
Optional
maxResults Max Results integer
Maximum number of registers to be fetched.
Required
showCompleted Show Completed boolean
Whether completed tasks are returned in the result.
Optional
showDeleted Show Deleted boolean
Whether deleted tasks are returned in the result.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
google_tasks-search-tasks
Version
0.0.2
App
Google Tasks
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes