# Pipedrive — Pipedream Connect

> Pipedrive is the easy-to-use, #1 user-rated CRM tool. Get more qualified leads and grow your business with Pipedrive's sales CRM.

- API slug: `pipedrive` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: CRM
- Website: https://www.pipedrive.com/
- This page (HTML): https://pipedream.com/apps/pipedrive
- Tools: 41 actions · 6 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: pipedrive`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "pipedrive",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Activity:
const result = await mcp.callTool({
  name: "pipedrive-add-activity",
  arguments: {
    subject: "Subject",
    type: "Type",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Pipedrive endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-add-activity",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pipedrive: { authProvisionId: "apn_xxxxxxx" },
    subject: "Subject",
    type: "Type",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (41)

### `pipedrive-add-activity` — Add Activity (Write)

Adds a new activity. Includes more_activities_scheduled_in_context property in response's additional_data which indicates whether there are more undone activities scheduled with the same deal, person or organization (depending on the supplied data). See the Pipedrive API docs for Activities here…

Full schema: https://pipedream.com/apps/pipedrive/actions/add-activity.md

### `pipedrive-add-deal` — Add Deal (Write)

Adds a new deal. See the Pipedrive API docs for Deals here

Full schema: https://pipedream.com/apps/pipedrive/actions/add-deal.md

### `pipedrive-add-labels` — Add Labels (Write)

Adds labels to a lead, person, deal, or organization in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/add-labels.md

### `pipedrive-add-lead` — Add Lead (Write)

Create a new lead in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/add-lead.md

### `pipedrive-add-note` — Add Note (Write)

Adds a new note. For info on adding an note in Pipedrive

Full schema: https://pipedream.com/apps/pipedrive/actions/add-note.md

### `pipedrive-add-organization` — Add Organization (Write)

Adds a new organization. See the Pipedrive API docs for Organizations here

Full schema: https://pipedream.com/apps/pipedrive/actions/add-organization.md

### `pipedrive-add-person` — Add Person (Write)

Adds a new person. See the Pipedrive API docs for People here

Full schema: https://pipedream.com/apps/pipedrive/actions/add-person.md

### `pipedrive-create-project` — Create Project (Write)

Creates a new project in Pipedrive. Use List Project Boards to obtain a valid Board ID and List Project Phases to obtain a valid Phase ID before running this action. Example: to open a project on the first board/phase, call with title="Q3 Website Redesign", status="open", boardId="1", phaseId="1"…

Full schema: https://pipedream.com/apps/pipedrive/actions/create-project.md

### `pipedrive-create-task` — Create Task (Write)

Creates a new task under a project (BETA). Run List Projects first to obtain a valid project ID. Use List User ID Options for the assignee ID. Example: to add a task to a project, call with title="Draft kickoff agenda" and projectId="7" -> returns the created task with its numeric id. See the…

Full schema: https://pipedream.com/apps/pipedrive/actions/create-task.md

### `pipedrive-delete-project` — Delete Project (Write)

Permanently deletes a project. This is irreversible. Run List Projects first to obtain a valid project ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/delete-project.md

### `pipedrive-delete-task` — Delete Task (Write)

Permanently deletes a task and all of its subtasks (BETA). This is irreversible. Run List Tasks first to obtain a valid task ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/delete-task.md

### `pipedrive-get-all-leads` — Get All Leads (Read-only)

Get all leads from Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-all-leads.md

### `pipedrive-get-deal` — Get Deal (Read-only)

Get a deal by its ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-deal.md

### `pipedrive-get-lead-by-id` — Get Lead by ID (Read-only)

Get a lead by its ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-lead-by-id.md

### `pipedrive-get-person-details` — Get person details (Read-only)

Get details of a person by their ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-person-details.md

### `pipedrive-get-project` — Get Project (Read-only)

Gets a single project by its ID. Run List Projects first to obtain a valid project ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-project.md

### `pipedrive-get-task` — Get Task (Read-only)

Gets a single task by its ID (BETA). Run List Tasks first to obtain a valid task ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/get-task.md

### `pipedrive-list-deals` — List Deals (Read-only)

List deals in your Pipedrive account. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-deals.md

### `pipedrive-list-filters` — List Filters (Read-only)

List filters in your Pipedrive account, optionally scoped to a single entity type. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-filters.md

### `pipedrive-list-lead-label-ids-options` — List Lead Label IDs Options (Read-only)

Retrieves available options for the Lead Label IDs field.

Full schema: https://pipedream.com/apps/pipedrive/actions/list-lead-label-ids-options.md

### `pipedrive-list-organization-label-ids-options` — List Organization Label IDs Options (Read-only)

Retrieves available options for the Organization Label IDs field.

Full schema: https://pipedream.com/apps/pipedrive/actions/list-organization-label-ids-options.md

### `pipedrive-list-organizations` — List Organizations (Read-only)

List organizations in your Pipedrive account. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-organizations.md

### `pipedrive-list-person-label-ids-options` — List Person Label IDs Options (Read-only)

Retrieves available options for the Person Label IDs field.

Full schema: https://pipedream.com/apps/pipedrive/actions/list-person-label-ids-options.md

### `pipedrive-list-persons` — List Persons (Read-only)

List persons in your Pipedrive account. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-persons.md

### `pipedrive-list-project-boards` — List Project Boards (Read-only)

Lists all active project boards. Run this first to obtain a valid board ID for Create Project, Update Project, and List Project Phases. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-project-boards.md

### `pipedrive-list-project-phases` — List Project Phases (Read-only)

Lists the phases for a given board. Run List Project Boards first to obtain a board ID, then run this to obtain a valid phase ID for Create Project or Update Project. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-project-phases.md

### `pipedrive-list-projects` — List Projects (Read-only)

Lists projects in your Pipedrive account. Use the returned IDs with Get Project, Update Project, Delete Project, or Create Task. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/list-projects.md

### `pipedrive-list-tasks` — List Tasks (Read-only)

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

Full schema: https://pipedream.com/apps/pipedrive/actions/list-tasks.md

### `pipedrive-list-user-id-options` — List User ID Options (Read-only)

Retrieves available options for the User ID field.

Full schema: https://pipedream.com/apps/pipedrive/actions/list-user-id-options.md

### `pipedrive-merge-deals` — Merge Deals (Write)

Merge two deals in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/merge-deals.md

### `pipedrive-merge-persons` — Merge Persons (Write)

Merge two persons in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/merge-persons.md

### `pipedrive-remove-duplicate-notes` — Remove Duplicate Notes (Write)

Remove duplicate notes from an object in Pipedrive. See the documentation for getting notes and deleting notes

Full schema: https://pipedream.com/apps/pipedrive/actions/remove-duplicate-notes.md

### `pipedrive-remove-labels` — Remove Labels (Write)

Removes one or more specific labels from a lead, person, deal, or organization in Pipedrive, leaving all other labels intact. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/remove-labels.md

### `pipedrive-search-leads` — Search Leads (Read-only)

Search for leads by name or email. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/search-leads.md

### `pipedrive-search-notes` — Search Notes (Read-only)

Search for notes in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/search-notes.md

### `pipedrive-search-persons` — Search persons (Read-only)

Searches all Persons by name, email, phone, notes and/or custom fields. This endpoint is a wrapper of /v1/itemSearch with a narrower OAuth scope. Found Persons can be filtered by Organization ID. See the Pipedrive API docs here

Full schema: https://pipedream.com/apps/pipedrive/actions/search-persons.md

### `pipedrive-update-deal` — Update Deal (Write)

Updates the properties of a deal. See the Pipedrive API docs for Deals here

Full schema: https://pipedream.com/apps/pipedrive/actions/update-deal.md

### `pipedrive-update-lead` — Update Lead (Write)

Updates a lead in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/update-lead.md

### `pipedrive-update-person` — Update Person (Write)

Updates an existing person in Pipedrive. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/update-person.md

### `pipedrive-update-project` — Update Project (Write)

Updates an existing project. Run List Projects first to obtain a valid project ID; use List Project Boards and List Project Phases for board and phase IDs. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/update-project.md

### `pipedrive-update-task` — Update Task (Write)

Updates an existing task (BETA). Run List Tasks first to obtain a valid task ID. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/actions/update-task.md

## Triggers (6)

### `pipedrive-updated-deal-instant` — Deal Updated (Instant) (Instant)

Emit new event when a deal is updated.

Full schema: https://pipedream.com/apps/pipedrive/triggers/updated-deal-instant.md

### `pipedrive-updated-lead-instant` — Lead Updated (Instant) (Instant)

Emit new event when a lead is updated.

Full schema: https://pipedream.com/apps/pipedrive/triggers/updated-lead-instant.md

### `pipedrive-new-deal-instant` — New Deal (Instant) (Instant)

Emit new event when a new deal is created.

Full schema: https://pipedream.com/apps/pipedrive/triggers/new-deal-instant.md

### `pipedrive-new-event-instant` — New Event (Instant) (Instant)

Emit new event when a new webhook event is received. See the documentation

Full schema: https://pipedream.com/apps/pipedrive/triggers/new-event-instant.md

### `pipedrive-new-person-instant` — New Person (Instant) (Instant)

Emit new event when a new person is created.

Full schema: https://pipedream.com/apps/pipedrive/triggers/new-person-instant.md

### `pipedrive-updated-person-instant` — Person Updated (Instant) (Instant)

Emit new event when a person is updated.

Full schema: https://pipedream.com/apps/pipedrive/triggers/updated-person-instant.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt