View as Markdown
Pipedrive icon

Pipedrive ACTION

List Tasks

Lists tasks in your Pipedrive account (BETA). Use List Projects to obtain a project ID to filter by. Use the returned IDs with Get Task, Update Task, or Delete Task. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pipedrive account once, then configure and run List 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: "pipedrive-list-tasks",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pipedrive: { authProvisionId: "apn_xxxxxxx" },
    projectId: "Project ID",
    assigneeId: 10,
  },
})

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.

List Tasks inputs
Property Type Description
projectId Project ID string
Filter tasks by project ID. Run List Projects first to obtain a valid project ID.
Optional
assigneeId Assignee ID integer
Filter tasks by assignee (user) ID.
Optional Dynamic
parentTaskId Parent Task ID string
Filter by parent task ID. Omit to return all tasks (default); provide an integer to return only subtasks of that specific task. (Note: the API also accepts null to return only root-level tasks, but this prop cannot represent a null value — use a downstream filter step to restrict to root-level tasks.)
Optional
isDone Is Done boolean
Filter by completion state (true = done, false = not done).
Optional
isMilestone Is Milestone boolean
Filter to only milestone tasks (true) or non-milestone tasks (false).
Optional
limit Limit integer
For pagination, the number of entries to return. Min 1, max 500 (the API cap). Defaults to 100 if omitted.
Optional
cursor Cursor string
For pagination, the cursor to the next page of results (from additional_data.next_cursor). If omitted, the first page is returned.
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
pipedrive-list-tasks
Version
0.0.2
App
Pipedrive
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes