View as Markdown
ClickUp icon

ClickUp ACTION

Get Tasks

Get a list of tasks. See the documentation in Tasks / Get Tasks section.
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's ClickUp account once, then configure and run Get 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: "clickup-get-tasks",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    clickup: { authProvisionId: "apn_xxxxxxx" },
    workspaceId: "Workspace",
    spaceId: "Space",
  },
})

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.

Get Tasks inputs
Property Type Description
workspaceId Workspace string
The id of a workspace
Required Dynamic
spaceId Space string
If selected, the Lists will be filtered by this Space ID
Required Dynamic
archived Archived boolean
Filter for archived tasks
Optional
page Page integer
The page number to be returned
Optional
orderBy Order By string
Order to return tasks
Optional
assignees Assignees string[]
Select the assignees
Optional Dynamic
folderId Folder ID string
The ID of a folder
Optional Dynamic
listId List ID string
The ID of a list. To show lists within a folder, please select a Folder first
Required Dynamic
statuses Statuses string[]
Filter tasks by one or more statuses
Optional Dynamic
includeMarkdownDescription Include Markdown Description boolean
Return task descriptions in Markdown format
Optional
subtasks Include Subtasks boolean
Include subtasks in the response
Optional
includeClosed Include Closed boolean
Include tasks with a Closed status. By default, closed tasks are not returned
Optional
includeTiml Include Tasks in Multiple Lists (TIML) boolean
Include tasks that exist in multiple lists
Optional
watchers Watchers string[]
Filter tasks by watchers
Optional Dynamic
tags Tags string[]
Select the tags
Optional Dynamic
dueDateGt Due Date Greater Than integer
Filter tasks with a due date greater than the Unix timestamp (in milliseconds) provided
Optional
dueDateLt Due Date Less Than integer
Filter tasks with a due date less than the Unix timestamp (in milliseconds) provided
Optional
dateCreatedGt Date Created Greater Than integer
Filter tasks created after the Unix timestamp (in milliseconds) provided
Optional
dateCreatedLt Date Created Less Than integer
Filter tasks created before the Unix timestamp (in milliseconds) provided
Optional
dateUpdatedGt Date Updated Greater Than integer
Filter tasks updated after the Unix timestamp (in milliseconds) provided
Optional
dateDoneGt Date Done Greater Than integer
Filter tasks completed after the Unix timestamp (in milliseconds) provided
Optional
dateDoneLt Date Done Less Than integer
Filter tasks completed before the Unix timestamp (in milliseconds) provided
Optional
customItems Custom Items string[]
Filter by custom task types. Use 0 for Tasks and 1 for Milestones
Optional
customFields Custom Fields string[]
Filter tasks by custom field values. Use the Get Custom Fields action to retrieve valid field_id values for your list. Provide a JSON array of filter objects, e.g. [{"field_id": "abc", "operator": "=", "value": "foo"}]
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
clickup-get-tasks
Version
0.0.13
App
ClickUp
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes