> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Pipedrive MCP server

The Pipedrive MCP connector routes your AI agent's tool calls to Pipedrive's own MCP server through Scalekit. Each user signs in to Pipedrive once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 32 tools.

**Authentication:** OAuth2.1/DCR
**Categories:** CRM & Sales
**Tools:** 32: 19 read, 13 write, 0 destructive
**Users sign in with:** OAuth
**OAuth app:** Scalekit's or your own
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=PIPEDRIVEMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Pipedrive MCP connection

   In **AgentKit > Connections**, create a Pipedrive MCP connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

   Scalekit credentials are available for Pipedrive, so you don't need to register an OAuth app.

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'pipedrivemcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Pipedrive MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'pipedrivemcp_getactivities',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "pipedrivemcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Pipedrive MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="pipedrivemcp_getactivities",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'pipedrivemcp_getactivities',
  toolInput: {},
  connector: 'pipedrivemcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="pipedrivemcp_getactivities",
    tool_input={},
    connection_name="pipedrivemcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `pipedrivemcp_getactivities`

GetActivities · Read-only

Retrieves a list of all activities (calls, meetings, tasks, emails, etc.) with their subjects, due dates, types, and linked deals/persons. Filter by user_id, deal_id, type, or done status to narrow results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from a previous response to fetch the next page.
- `deal_id` (`number`, optional): Filter activities by the ID of the linked deal.
- `done` (`boolean`, optional): Filter by completion status. Set to true to retrieve only done activities, false for pending.
- `filter_id` (`number`, optional): The ID of the filter to apply to the activities list.
- `ids` (`string`, optional): Comma-separated list of activity IDs to retrieve.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `lead_id` (`string`, optional): Filter activities by the UUID of the linked lead.
- `limit` (`number`, optional): Maximum number of activities to return per page.
- `org_id` (`number`, optional): Filter activities by the ID of the linked organization.
- `owner_id` (`number`, optional): Filter activities by the ID of the user who owns them.
- `person_id` (`number`, optional): Filter activities by the ID of the linked person.
- `sort_by` (`string`, optional): Field to sort results by (e.g., due_date, add_time).
- `sort_direction` (`string`, optional): Sort direction: asc or desc.
- `updated_since` (`string`, optional): Return activities updated after this date-time (ISO 8601 format).
- `updated_until` (`string`, optional): Return activities updated before this date-time (ISO 8601 format).

Example input: `{}`

### `pipedrivemcp_getactivity`

GetActivity · Read-only

Retrieves complete details of a specific activity by ID, including type, subject, due date, duration, participants, and linked deal/person/organization.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the activity to retrieve.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.

Example input: `{"id":1}`

### `pipedrivemcp_getdeal`

GetDeal · Read-only

Retrieves complete details of a specific deal by ID, including value, stage, win probability, associated person/organization, and custom fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the deal to retrieve.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): Whether to include deal label details.
- `include_option_labels` (`boolean`, optional): Whether to include labels for option-type custom fields.

Example input: `{"id":1}`

### `pipedrivemcp_getdeals`

GetDeals · Read-only

Retrieves a list of all active (non-archived) deals in the system with their titles, values, stages, and associated contacts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from a previous response to fetch the next page.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include.
- `filter_id` (`number`, optional): The ID of the filter to apply to the deals list.
- `ids` (`string`, optional): Comma-separated list of deal IDs to retrieve.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): Whether to include deal label details.
- `include_option_labels` (`boolean`, optional): Whether to include labels for option-type custom fields.
- `limit` (`number`, optional): Maximum number of deals to return per page.
- `org_id` (`number`, optional): Filter deals by the ID of the associated organization.
- `owner_id` (`number`, optional): Filter deals by the ID of the user who owns them.
- `person_id` (`number`, optional): Filter deals by the ID of the associated person.
- `pipeline_id` (`number`, optional): Filter deals by pipeline ID.
- `sort_by` (`string`, optional): Field to sort results by (e.g., add_time, update_time, value).
- `sort_direction` (`string`, optional): Sort direction: asc or desc.
- `stage_id` (`number`, optional): Filter deals by stage ID.
- `status` (`string`, optional): Filter deals by status (open, won, lost, deleted).
- `updated_since` (`string`, optional): Return deals updated after this date-time (ISO 8601 format).
- `updated_until` (`string`, optional): Return deals updated before this date-time (ISO 8601 format).

Example input: `{}`

### `pipedrivemcp_getlead`

GetLead · Read-only

Returns full details of a specific lead by ID, including title, value, expected close date, and linked person/organization. Prefer this over getLeads when you have the lead ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): The ID of the lead.

Example input: `{"id":"<id>"}`

### `pipedrivemcp_getleadconversionstatus`

GetLeadConversionStatus · Read-only

Retrieves the status of a lead-to-deal conversion by conversion ID. Use this to check whether a conversion initiated by convertLeadToDeal has completed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conversion_id` (`string`, required): The conversion ID returned by convertLeadToDeal.
- `id` (`string`, required): The ID of the lead that was converted.

Example input: `{"conversion_id":"<conversion_id>","id":"<id>"}`

### `pipedrivemcp_getleads`

GetLeads · Read-only

Returns a paginated list of non-archived leads sorted by creation time. Use limit/start for pagination, or filter by owner, person, or organization to narrow results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filter_id` (`integer`, optional): The ID of the filter to use.
- `limit` (`integer`, optional): The number of leads to return per page.
- `organization_id` (`integer`, optional): Filter leads linked to a specific organization.
- `owner_id` (`integer`, optional): Filter leads by the ID of their owner.
- `person_id` (`integer`, optional): Filter leads linked to a specific person.
- `sort` (`string`, optional): Field name and sort direction, e.g. 'add_time DESC'.
- `start` (`integer`, optional): Pagination start offset.
- `updated_since` (`string`, optional): Return leads updated after this date/time in ISO 8601 format.

Example input: `{}`

### `pipedrivemcp_getnote`

GetNote · Read-only

Retrieves complete details of a specific note by ID, including content, author, and linked entities.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the note.

Example input: `{"id":1}`

### `pipedrivemcp_getnotes`

GetNotes · Read-only

Retrieves a list of notes. Filter by deal_id, person_id, org_id, or lead_id to get notes linked to specific entities.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deal_id` (`number`, optional): Filter notes linked to a specific deal.
- `end_date` (`string`, optional): The date (YYYY-MM-DD) until which notes should be fetched.
- `lead_id` (`string`, optional): Filter notes linked to a specific lead.
- `limit` (`number`, optional): The number of results to return per page.
- `org_id` (`number`, optional): Filter notes linked to a specific organization.
- `person_id` (`number`, optional): Filter notes linked to a specific person.
- `pinned_to_deal_flag` (`number`, optional): Filter results by note-to-deal pinning state.
- `pinned_to_lead_flag` (`number`, optional): Filter results by note-to-lead pinning state.
- `pinned_to_organization_flag` (`number`, optional): Filter results by note-to-organization pinning state.
- `pinned_to_person_flag` (`number`, optional): Filter results by note-to-person pinning state.
- `pinned_to_project_flag` (`number`, optional): Filter results by note-to-project pinning state.
- `pinned_to_task_flag` (`number`, optional): Filter results by note-to-task pinning state.
- `project_id` (`number`, optional): Filter notes linked to a specific project.
- `sort` (`string`, optional): Field name and sort direction, e.g. 'update_time DESC'. Supported fields: id, user_id, deal_id, person_id, org_id, content, add_time, update_time.
- `start` (`number`, optional): Pagination start offset.
- `start_date` (`string`, optional): The date (YYYY-MM-DD) from which notes should be fetched.
- `task_id` (`number`, optional): Filter notes linked to a specific task.
- `updated_since` (`string`, optional): Return notes updated after this date/time in RFC3339 format.
- `user_id` (`number`, optional): Filter notes by the ID of their owner (user).

Example input: `{}`

### `pipedrivemcp_getorganization`

GetOrganization · Read-only

Retrieves complete details of a specific organization by ID, including name, address, associated persons, and deal history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the organization.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include in the response.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): If true, the response will include label names assigned to the organization.
- `include_option_labels` (`boolean`, optional): If true, option field values will include their labels in addition to IDs.

Example input: `{"id":1}`

### `pipedrivemcp_getorganizations`

GetOrganizations · Read-only

Retrieves a list of all organizations (companies) in the CRM with their names, addresses, and associated persons/deals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from a previous response to retrieve the next page.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include in the response.
- `filter_id` (`number`, optional): The ID of a saved filter to apply when fetching organizations.
- `ids` (`string`, optional): Comma-separated list of organization IDs to retrieve.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): If true, the response will include label names assigned to each organization.
- `include_option_labels` (`boolean`, optional): If true, option field values will include their labels in addition to IDs.
- `limit` (`number`, optional): Maximum number of organizations to return per page.
- `owner_id` (`number`, optional): Filter organizations by the ID of the owning user.
- `sort_by` (`string`, optional): Field name to sort results by, e.g. name or update_time.
- `sort_direction` (`string`, optional): Sort direction: asc or desc.
- `updated_since` (`string`, optional): Return organizations updated after this ISO 8601 datetime.
- `updated_until` (`string`, optional): Return organizations updated before this ISO 8601 datetime.

Example input: `{}`

### `pipedrivemcp_getperson`

GetPerson · Read-only

Retrieves complete details of a specific contact person by ID, including name, email, phone, organization, and deal associations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the person.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include in the response.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): If true, the response will include label names assigned to the person.
- `include_option_labels` (`boolean`, optional): If true, option field values will include their labels in addition to IDs.

Example input: `{"id":1}`

### `pipedrivemcp_getpersons`

GetPersons · Read-only

Retrieves a list of all contact persons in the system with their names, emails, phone numbers, and organization associations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from a previous response to fetch the next page.
- `custom_fields` (`string`, optional): Comma-separated list of custom field keys to include.
- `deal_id` (`number`, optional): Filter persons by the ID of an associated deal.
- `filter_id` (`number`, optional): The ID of the filter to apply to the persons list.
- `ids` (`string`, optional): Comma-separated list of person IDs to retrieve.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `include_labels` (`boolean`, optional): Whether to include person label details.
- `include_option_labels` (`boolean`, optional): Whether to include labels for option-type custom fields.
- `limit` (`number`, optional): Maximum number of persons to return per page.
- `org_id` (`number`, optional): Filter persons by the ID of their associated organization.
- `owner_id` (`number`, optional): Filter persons by the ID of the user who owns them.
- `sort_by` (`string`, optional): Field to sort results by (e.g., name, add_time, update_time).
- `sort_direction` (`string`, optional): Sort direction: asc or desc.
- `updated_since` (`string`, optional): Return persons updated after this date-time (ISO 8601 format).
- `updated_until` (`string`, optional): Return persons updated before this date-time (ISO 8601 format).

Example input: `{}`

### `pipedrivemcp_getstage`

GetStage · Read-only

Retrieves details of a specific pipeline stage by ID, including its name, pipeline, order, and win probability.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the stage.

Example input: `{"id":1}`

### `pipedrivemcp_getstages`

GetStages · Read-only

Retrieves all pipeline stages. Optionally filter by pipeline_id to get stages for a specific pipeline. Use stage IDs when creating or updating deals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the next page of results.
- `limit` (`integer`, optional): The number of results to return per page.
- `pipeline_id` (`integer`, optional): If provided, only stages belonging to this pipeline are returned.
- `sort_by` (`string`, optional): The field to sort by. Supported fields: id, update_time, add_time, order_nr.
- `sort_direction` (`string`, optional): The sorting direction. Supported values: asc, desc.

Example input: `{}`

### `pipedrivemcp_searchdeals`

SearchDeals · Read-only

Searches for deals by title, notes, or custom field values. Results can be filtered by associated person or organization.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): The search term to look for. Minimum 2 characters.
- `cursor` (`string`, optional): Pagination cursor from a previous response to fetch the next page.
- `exact_match` (`boolean`, optional): Whether to match the search term exactly (case-insensitive).
- `fields` (`string`, optional): Comma-separated list of fields to search in (e.g., title, notes, custom_fields).
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `limit` (`number`, optional): Maximum number of results to return per page.
- `organization_id` (`number`, optional): Filter results to deals associated with this organization ID.
- `person_id` (`number`, optional): Filter results to deals associated with this person ID.
- `status` (`string`, optional): Filter results by deal status (open, won, lost).

Example input: `{"term":"<term>"}`

### `pipedrivemcp_searchleads`

SearchLeads · Read-only

Searches for leads by title or custom field values. Use this to find leads when you don't have the lead ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): The search term to look for. Minimum 2 characters.
- `cursor` (`string`, optional): Pagination cursor from a previous response to retrieve the next page.
- `exact_match` (`boolean`, optional): If true, only exact matches are returned. Default is false (partial match).
- `fields` (`string`, optional): A comma-separated list of fields to search in. Defaults to all.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `limit` (`integer`, optional): Maximum number of leads to return per page.
- `organization_id` (`integer`, optional): Will filter leads by the provided organization ID. The upper limit of found leads associated with the organization is 2000.
- `person_id` (`integer`, optional): Will filter leads by the provided person ID. The upper limit of found leads associated with the person is 2000.

Example input: `{"term":"<term>"}`

### `pipedrivemcp_searchorganization`

SearchOrganization · Read-only

Searches for organizations by name, address, or custom field values. Use this to find organizations when you don't have the org ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): The search term to look for. Minimum 2 characters.
- `cursor` (`string`, optional): Pagination cursor for the next page of results.
- `exact_match` (`boolean`, optional): When true, only full exact matches are returned.
- `fields` (`string`, optional): A comma-separated string of fields to search in.
- `limit` (`integer`, optional): The number of results to return per page.

Example input: `{"term":"<term>"}`

### `pipedrivemcp_searchpersons`

SearchPersons · Read-only

Searches for persons by name, email, phone, or custom field values. Use this to find contacts when you don't have the person ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): The search term to look for. Minimum 2 characters.
- `cursor` (`string`, optional): Pagination cursor for the next page of results.
- `exact_match` (`boolean`, optional): When true, only full exact matches are returned.
- `fields` (`string`, optional): A comma-separated string of fields to search in.
- `include_fields` (`string`, optional): Comma-separated list of additional fields to include in the response.
- `limit` (`number`, optional): The number of results to return per page.
- `organization_id` (`number`, optional): Filter results to persons associated with this organization.

Example input: `{"term":"<term>"}`

### `pipedrivemcp_addactivity`

AddActivity · Write

Creates a new activity (call, meeting, task, email, deadline, or lunch) and optionally links it to a deal, lead, person, or organization.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `attendees` (`array`, optional): List of calendar attendees for the activity.
- `busy` (`boolean`, optional): Whether the activity marks the user as busy in the calendar.
- `deal_id` (`number`, optional): The ID of the deal to link this activity to.
- `done` (`boolean`, optional): Whether the activity is marked as done.
- `due_date` (`string`, optional): The due date for the activity in YYYY-MM-DD format.
- `due_time` (`string`, optional): The due time for the activity in HH:MM format.
- `duration` (`string`, optional): The duration of the activity in HH:MM format.
- `lead_id` (`string`, optional): The UUID of the lead to link this activity to.
- `location` (`object`, optional): The location details for the activity.
- `note` (`string`, optional): A private note for the activity.
- `org_id` (`number`, optional): The ID of the organization to link this activity to.
- `owner_id` (`number`, optional): The ID of the user to assign this activity to.
- `participants` (`array`, optional): List of persons participating in the activity.
- `person_id` (`number`, optional): The ID of the person to link this activity to.
- `priority` (`number`, optional): The priority level of the activity.
- `project_id` (`number`, optional): The ID of the project to link this activity to.
- `public_description` (`string`, optional): A public note or description visible to all participants.
- `subject` (`string`, optional): The subject/title of the activity.
- `type` (`string`, optional): The type of activity (e.g., call, meeting, task, email, deadline, lunch).

Example input: `{}`

### `pipedrivemcp_adddeal`

AddDeal · Write

Creates a new deal. Requires title; optionally set value, currency, stage_id, pipeline_id, expected_close_date, person_id, and org_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): The title of the deal.
- `archive_time` (`string`, optional): The date-time when the deal was archived (ISO 8601 format).
- `close_time` (`string`, optional): The date-time the deal was closed (ISO 8601 format).
- `currency` (`string`, optional): The currency code for the deal value (e.g., USD, EUR).
- `custom_fields` (`object`, optional): Custom field values as key-value pairs.
- `expected_close_date` (`string`, optional): The expected close date in YYYY-MM-DD format.
- `is_archived` (`boolean`, optional): Whether the deal is archived.
- `is_deleted` (`boolean`, optional): Whether the deal is deleted.
- `label_ids` (`array`, optional): List of label IDs to assign to this deal.
- `lost_reason` (`string`, optional): The reason the deal was lost (when setting status to lost).
- `lost_time` (`string`, optional): The date-time the deal was lost (ISO 8601 format).
- `org_id` (`number`, optional): The ID of the organization associated with this deal.
- `owner_id` (`number`, optional): The ID of the user who owns this deal.
- `person_id` (`number`, optional): The ID of the person associated with this deal.
- `pipeline_id` (`number`, optional): The ID of the pipeline this deal belongs to.
- `probability` (`number`, optional): The win probability percentage (0–100) for the deal.
- `stage_id` (`number`, optional): The ID of the pipeline stage for this deal.
- `status` (`string`, optional): The status of the deal (open, won, lost).
- `value` (`number`, optional): The monetary value of the deal.
- `visible_to` (`number`, optional): Visibility setting for the deal (1=owner only, 3=entire company).
- `won_time` (`string`, optional): The date-time the deal was won (ISO 8601 format).

Example input: `{"title":"<title>"}`

### `pipedrivemcp_addlead`

AddLead · Write

Creates a new lead and links it to a person, organization, or both (at least one required). Use to capture prospects before they become deals.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): The title of the lead.
- `channel` (`number`, optional): The marketing channel ID for this lead.
- `channel_id` (`string`, optional): The ID of the marketing channel's sub-source.
- `expected_close_date` (`string`, optional): Expected close date in YYYY-MM-DD format.
- `label_ids` (`array`, optional): A list of label IDs to assign to this lead.
- `organization_id` (`integer`, optional): The ID of the organization to link this lead to.
- `origin_id` (`string`, optional): The origin channel ID that generated this lead.
- `owner_id` (`integer`, optional): The ID of the user who owns this lead.
- `person_id` (`integer`, optional): The ID of the person to link this lead to.
- `value` (`object`, optional): The monetary value of the lead.
- `visible_to` (`string`, optional): Visibility setting for the lead.
- `was_seen` (`boolean`, optional): Whether the lead has been seen.

Example input: `{"title":"<title>"}`

### `pipedrivemcp_addnote`

AddNote · Write

Creates a new note linked to at least one entity (person, deal, organization, or lead). content is required and at least one of person_id, deal_id, org_id, or lead_id must be provided.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): The content of the note in plain text or HTML.
- `add_time` (`string`, optional): The creation date and time of the note.
- `deal_id` (`number`, optional): Link this note to a deal by its ID.
- `lead_id` (`string`, optional): Link this note to a lead by its ID.
- `org_id` (`number`, optional): Link this note to an organization by its ID.
- `person_id` (`number`, optional): Link this note to a person by their ID.
- `pinned_to_deal_flag` (`number`, optional): Pin this note to the linked deal.
- `pinned_to_lead_flag` (`number`, optional): Pin this note to the linked lead.
- `pinned_to_organization_flag` (`number`, optional): Pin this note to the linked organization.
- `pinned_to_person_flag` (`number`, optional): Pin this note to the linked person.
- `pinned_to_project_flag` (`number`, optional): Pin this note to the linked project.
- `pinned_to_task_flag` (`number`, optional): Pin this note to the linked task.
- `project_id` (`number`, optional): Link this note to a project by its ID.
- `task_id` (`number`, optional): Link this note to a task by its ID.
- `user_id` (`number`, optional): The ID of the user who owns the note.

Example input: `{"content":"<content>"}`

### `pipedrivemcp_addorganization`

AddOrganization · Write

Creates a new organization (company). Name is required; optionally set owner_id, address, and custom fields.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The name of the organization.
- `add_time` (`string`, optional): The creation date and time of the organization.
- `address` (`object`, optional): The organization's address.
- `annual_revenue` (`number`, optional): The organization's annual revenue.
- `custom_fields` (`object`, optional): A map of custom field keys to their values.
- `employee_count` (`number`, optional): The organization's employee count.
- `industry` (`number`, optional): The ID of the organization's industry.
- `label_ids` (`array`, optional): A list of label IDs to assign to this organization.
- `linkedin` (`string`, optional): The organization's LinkedIn profile URL.
- `owner_id` (`number`, optional): The ID of the user who owns this organization.
- `visible_to` (`number`, optional): Visibility setting for the organization. 1 = owner only, 3 = entire company.
- `website` (`string`, optional): The organization's website URL.

Example input: `{"name":"<name>"}`

### `pipedrivemcp_addperson`

AddPerson · Write

Creates a new contact person. Name is required; optionally set email, phone, org_id, and owner_id to link them to an organization and sales rep.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The full name of the person.
- `add_time` (`string`, optional): The creation date and time of the person.
- `birthday` (`string`, optional): The person's date of birth.
- `custom_fields` (`object`, optional): A map of custom field keys to their values.
- `emails` (`array`, optional): A list of email addresses for this person.
- `im` (`array`, optional): A list of instant messenger identifiers for this person.
- `job_title` (`string`, optional): The person's job title.
- `label_ids` (`array`, optional): A list of label IDs to assign to this person.
- `marketing_status` (`string`, optional): Marketing opt-in status for the person, e.g. subscribed or unsubscribed.
- `notes` (`string`, optional): Free-text notes about this person.
- `org_id` (`number`, optional): The ID of the organization to link this person to.
- `owner_id` (`number`, optional): The ID of the user who owns this person record.
- `phones` (`array`, optional): A list of phone numbers for this person.
- `postal_address` (`object`, optional): The person's postal address.
- `visible_to` (`number`, optional): Visibility setting for the person. 1 = owner only, 3 = entire company.

Example input: `{"name":"<name>"}`

### `pipedrivemcp_convertleadtodeal`

ConvertLeadToDeal · Write

Converts an existing lead into a deal. The lead is removed and a new deal is created with the lead's data. Optionally specify a pipeline and stage for the new deal.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): The ID of the lead to convert.
- `pipeline_id` (`integer`, optional): The pipeline to place the new deal in.
- `stage_id` (`integer`, optional): The stage to place the new deal in.

Example input: `{"id":"<id>"}`

### `pipedrivemcp_updateactivity`

UpdateActivity · Write

Modifies an existing activity's properties such as subject, type, due date, duration, or assigned user. Set done=true to mark it completed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the activity to update.
- `attendees` (`array`, optional): List of calendar attendees for the activity.
- `busy` (`boolean`, optional): Whether the activity marks the user as busy in the calendar.
- `deal_id` (`number`, optional): The ID of the deal to link this activity to.
- `done` (`boolean`, optional): Set to true to mark the activity as completed.
- `due_date` (`string`, optional): The due date for the activity in YYYY-MM-DD format.
- `due_time` (`string`, optional): The due time for the activity in HH:MM format.
- `duration` (`string`, optional): The duration of the activity in HH:MM format.
- `lead_id` (`string`, optional): The UUID of the lead to link this activity to.
- `location` (`object`, optional): The location details for the activity.
- `note` (`string`, optional): A private note for the activity.
- `org_id` (`number`, optional): The ID of the organization to link this activity to.
- `owner_id` (`number`, optional): The ID of the user to assign this activity to.
- `participants` (`array`, optional): List of persons participating in the activity.
- `person_id` (`number`, optional): The ID of the person to link this activity to.
- `priority` (`number`, optional): The priority level of the activity.
- `project_id` (`number`, optional): The ID of the project to link this activity to.
- `public_description` (`string`, optional): A public note or description visible to all participants.
- `subject` (`string`, optional): The subject/title of the activity.
- `type` (`string`, optional): The type of activity (e.g., call, meeting, task, email, deadline, lunch).

Example input: `{"id":1}`

### `pipedrivemcp_updatedeal`

UpdateDeal · Write

Modifies an existing deal's properties such as title, value, stage_id, expected_close_date, or custom fields. Set status to 'won' or 'lost' to close a deal.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the deal to update.
- `archive_time` (`string`, optional): The date-time when the deal was archived (ISO 8601 format).
- `close_time` (`string`, optional): The date-time the deal was closed (ISO 8601 format).
- `currency` (`string`, optional): The currency code for the deal value (e.g., USD, EUR).
- `custom_fields` (`object`, optional): Custom field values as key-value pairs.
- `expected_close_date` (`string`, optional): The expected close date in YYYY-MM-DD format.
- `is_archived` (`boolean`, optional): Whether the deal is archived.
- `is_deleted` (`boolean`, optional): Whether the deal is deleted.
- `label_ids` (`array`, optional): List of label IDs to assign to this deal.
- `lost_reason` (`string`, optional): The reason the deal was lost (when setting status to lost).
- `lost_time` (`string`, optional): The date-time the deal was lost (ISO 8601 format).
- `org_id` (`number`, optional): The ID of the organization associated with this deal.
- `owner_id` (`number`, optional): The ID of the user who owns this deal.
- `person_id` (`number`, optional): The ID of the person associated with this deal.
- `pipeline_id` (`number`, optional): The ID of the pipeline this deal belongs to.
- `probability` (`number`, optional): The win probability percentage (0–100) for the deal.
- `stage_id` (`number`, optional): The ID of the pipeline stage for this deal.
- `status` (`string`, optional): The status of the deal. Set to 'won' or 'lost' to close the deal.
- `title` (`string`, optional): The title of the deal.
- `value` (`number`, optional): The monetary value of the deal.
- `visible_to` (`number`, optional): Visibility setting for the deal (1=owner only, 3=entire company).
- `won_time` (`string`, optional): The date-time the deal was won (ISO 8601 format).

Example input: `{"id":1}`

### `pipedrivemcp_updatelead`

UpdateLead · Write

Updates one or more properties of a lead. Only fields included in the request are changed. Send null to clear a field (e.g. value, person_id, organization_id).

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): The ID of the lead to update.
- `channel` (`number`, optional): The marketing channel ID for this lead.
- `channel_id` (`string`, optional): The ID of the marketing channel's sub-source.
- `expected_close_date` (`string`, optional): Expected close date in YYYY-MM-DD format.
- `is_archived` (`boolean`, optional): Whether the lead is archived.
- `label_ids` (`array`, optional): A list of label IDs to assign to this lead.
- `organization_id` (`number`, optional): The ID of the organization to link this lead to. Send null to clear.
- `owner_id` (`integer`, optional): The ID of the user who owns this lead.
- `person_id` (`number`, optional): The ID of the person to link this lead to. Send null to clear.
- `title` (`string`, optional): The title of the lead.
- `value` (`object`, optional): The monetary value of the lead. Send null to clear.
- `visible_to` (`string`, optional): Visibility setting for the lead.
- `was_seen` (`boolean`, optional): Whether the lead has been seen.

Example input: `{"id":"<id>"}`

### `pipedrivemcp_updatenote`

UpdateNote · Write

Modifies an existing note's content or pin status.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the note.
- `add_time` (`string`, optional): The creation date and time of the note.
- `content` (`string`, optional): The updated content of the note.
- `deal_id` (`number`, optional): Link this note to a deal by its ID.
- `lead_id` (`string`, optional): Link this note to a lead by its ID.
- `org_id` (`number`, optional): Link this note to an organization by its ID.
- `person_id` (`number`, optional): Link this note to a person by their ID.
- `pinned_to_deal_flag` (`number`, optional): Pin or unpin this note from the linked deal.
- `pinned_to_lead_flag` (`number`, optional): Pin or unpin this note from the linked lead.
- `pinned_to_organization_flag` (`number`, optional): Pin or unpin this note from the linked organization.
- `pinned_to_person_flag` (`number`, optional): Pin or unpin this note from the linked person.
- `pinned_to_project_flag` (`number`, optional): Pin or unpin this note from the linked project.
- `pinned_to_task_flag` (`number`, optional): Pin or unpin this note from the linked task.
- `project_id` (`number`, optional): Link this note to a project by its ID.
- `task_id` (`number`, optional): Link this note to a task by its ID.
- `user_id` (`number`, optional): The ID of the user who owns the note.

Example input: `{"id":1}`

### `pipedrivemcp_updateorganization`

UpdateOrganization · Write

Modifies an existing organization's properties such as name, address, owner, or custom fields.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the organization to update.
- `address` (`object`, optional): The organization's address.
- `annual_revenue` (`number`, optional): The organization's annual revenue.
- `custom_fields` (`object`, optional): A map of custom field keys to their values.
- `employee_count` (`number`, optional): The organization's employee count.
- `industry` (`number`, optional): The ID of the organization's industry.
- `label_ids` (`array`, optional): A list of label IDs to assign to this organization.
- `linkedin` (`string`, optional): The organization's LinkedIn profile URL.
- `name` (`string`, optional): The name of the organization.
- `owner_id` (`number`, optional): The ID of the user who owns this organization.
- `visible_to` (`number`, optional): Visibility setting for the organization. 1 = owner only, 3 = entire company.
- `website` (`string`, optional): The organization's website URL.

Example input: `{"id":1}`

### `pipedrivemcp_updateperson`

UpdatePerson · Write

Modifies an existing contact person's properties such as name, email, phone, organization, or custom fields.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`number`, required): The ID of the person to update.
- `birthday` (`string`, optional): The person's date of birth.
- `custom_fields` (`object`, optional): A map of custom field keys to their values.
- `emails` (`array`, optional): A list of email addresses for this person.
- `im` (`array`, optional): A list of instant messenger identifiers for this person.
- `job_title` (`string`, optional): The person's job title.
- `label_ids` (`array`, optional): A list of label IDs to assign to this person.
- `marketing_status` (`string`, optional): Marketing opt-in status for the person, e.g. subscribed or unsubscribed.
- `name` (`string`, optional): The full name of the person.
- `notes` (`string`, optional): Free-text notes about this person.
- `org_id` (`number`, optional): The ID of the organization to link this person to.
- `owner_id` (`number`, optional): The ID of the user who owns this person record.
- `phones` (`array`, optional): A list of phone numbers for this person.
- `postal_address` (`object`, optional): The person's postal address.
- `visible_to` (`number`, optional): Visibility setting for the person. 1 = owner only, 3 = entire company.

Example input: `{"id":1}`

## Related

Other ways to connect Pipedrive:

- [OAuth](/agentkit/connectors/pipedrive/): Scalekit connector, OAuth, 105 tools

Other CRM & Sales connectors ([all 103](/agentkit/connectors/?category=crm-sales)):

- [Insightly](/agentkit/connectors/insightly/): Scalekit connector, API key, 108 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
