Pipedrive MCP

Vendor MCP32 toolsOAuth 2.1/DCRCRM & Sales

Connect to Pipedrive CRM via MCP to manage deals, contacts, organizations, leads, activities, and notes directly from your AI workflows.

Pipedrive MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'pipedrivemcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Pipedrive MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'pipedrivemcp_addactivity',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "pipedrivemcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Pipedrive MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="pipedrivemcp_addactivity",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Updatelead records — Updates one or more properties of a lead
Getleads records — Returns a paginated list of non-archived leads sorted by creation time
Getlead records — Returns full details of a specific lead by ID, including title, value, expected close date, and linked person/organization
Addlead records — Creates a new lead and links it to a person, organization, or both (at least one required)
Updateperson records — Modifies an existing contact person’s properties such as name, email, phone, organization, or custom fields
Updateorganization records — Modifies an existing organization’s properties such as name, address, owner, or custom fields

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

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

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

NameTypeRequiredDescription

attendeesarrayoptionalList of calendar attendees for the activity.

busybooleanoptionalWhether the activity marks the user as busy in the calendar.

deal_idnumberoptionalThe ID of the deal to link this activity to.

donebooleanoptionalWhether the activity is marked as done.

due_datestringoptionalThe due date for the activity in YYYY-MM-DD format.

due_timestringoptionalThe due time for the activity in HH:MM format.

durationstringoptionalThe duration of the activity in HH:MM format.

lead_idstringoptionalThe UUID of the lead to link this activity to.

locationobjectoptionalThe location details for the activity.

notestringoptionalA private note for the activity.

org_idnumberoptionalThe ID of the organization to link this activity to.

owner_idnumberoptionalThe ID of the user to assign this activity to.

participantsarrayoptionalList of persons participating in the activity.

person_idnumberoptionalThe ID of the person to link this activity to.

prioritynumberoptionalThe priority level of the activity.

project_idnumberoptionalThe ID of the project to link this activity to.

public_descriptionstringoptionalA public note or description visible to all participants.

subjectstringoptionalThe subject/title of the activity.

typestringoptionalThe type of activity (e.g., call, meeting, task, email, deadline, lunch).

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

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

NameTypeRequiredDescription

titlestringrequiredThe title of the deal.

archive_timestringoptionalThe date-time when the deal was archived (ISO 8601 format).

close_timestringoptionalThe date-time the deal was closed (ISO 8601 format).

currencystringoptionalThe currency code for the deal value (e.g., USD, EUR).

custom_fieldsobjectoptionalCustom field values as key-value pairs.

expected_close_datestringoptionalThe expected close date in YYYY-MM-DD format.

is_archivedbooleanoptionalWhether the deal is archived.

is_deletedbooleanoptionalWhether the deal is deleted.

label_idsarrayoptionalList of label IDs to assign to this deal.

lost_reasonstringoptionalThe reason the deal was lost (when setting status to lost).

lost_timestringoptionalThe date-time the deal was lost (ISO 8601 format).

org_idnumberoptionalThe ID of the organization associated with this deal.

owner_idnumberoptionalThe ID of the user who owns this deal.

person_idnumberoptionalThe ID of the person associated with this deal.

pipeline_idnumberoptionalThe ID of the pipeline this deal belongs to.

probabilitynumberoptionalThe win probability percentage (0–100) for the deal.

stage_idnumberoptionalThe ID of the pipeline stage for this deal.

statusstringoptionalThe status of the deal (open, won, lost).

valuenumberoptionalThe monetary value of the deal.

visible_tonumberoptionalVisibility setting for the deal (1=owner only, 3=entire company).

won_timestringoptionalThe date-time the deal was won (ISO 8601 format).

pipedrivemcp_addlead#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.12 params

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.

NameTypeRequiredDescription

titlestringrequiredThe title of the lead.

channelnumberoptionalThe marketing channel ID for this lead.

channel_idstringoptionalThe ID of the marketing channel's sub-source.

expected_close_datestringoptionalExpected close date in YYYY-MM-DD format.

label_idsarrayoptionalA list of label IDs to assign to this lead.

organization_idintegeroptionalThe ID of the organization to link this lead to.

origin_idstringoptionalThe origin channel ID that generated this lead.

owner_idintegeroptionalThe ID of the user who owns this lead.

person_idintegeroptionalThe ID of the person to link this lead to.

valueobjectoptionalThe monetary value of the lead.

visible_tostringoptionalVisibility setting for the lead.

was_seenbooleanoptionalWhether the lead has been seen.

pipedrivemcp_addnote#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.15 params

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.

NameTypeRequiredDescription

contentstringrequiredThe content of the note in plain text or HTML.

add_timestringoptionalThe creation date and time of the note.

deal_idnumberoptionalLink this note to a deal by its ID.

lead_idstringoptionalLink this note to a lead by its ID.

org_idnumberoptionalLink this note to an organization by its ID.

person_idnumberoptionalLink this note to a person by their ID.

pinned_to_deal_flagnumberoptionalPin this note to the linked deal.

pinned_to_lead_flagnumberoptionalPin this note to the linked lead.

pinned_to_organization_flagnumberoptionalPin this note to the linked organization.

pinned_to_person_flagnumberoptionalPin this note to the linked person.

pinned_to_project_flagnumberoptionalPin this note to the linked project.

pinned_to_task_flagnumberoptionalPin this note to the linked task.

project_idnumberoptionalLink this note to a project by its ID.

task_idnumberoptionalLink this note to a task by its ID.

user_idnumberoptionalThe ID of the user who owns the note.

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

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

NameTypeRequiredDescription

namestringrequiredThe name of the organization.

add_timestringoptionalThe creation date and time of the organization.

addressobjectoptionalThe organization's address.

annual_revenuenumberoptionalThe organization's annual revenue.

custom_fieldsobjectoptionalA map of custom field keys to their values.

employee_countnumberoptionalThe organization's employee count.

industrynumberoptionalThe ID of the organization's industry.

label_idsarrayoptionalA list of label IDs to assign to this organization.

linkedinstringoptionalThe organization's LinkedIn profile URL.

owner_idnumberoptionalThe ID of the user who owns this organization.

visible_tonumberoptionalVisibility setting for the organization. 1 = owner only, 3 = entire company.

websitestringoptionalThe organization's website URL.

pipedrivemcp_addperson#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.15 params

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.

NameTypeRequiredDescription

namestringrequiredThe full name of the person.

add_timestringoptionalThe creation date and time of the person.

birthdaystringoptionalThe person's date of birth.

custom_fieldsobjectoptionalA map of custom field keys to their values.

emailsarrayoptionalA list of email addresses for this person.

imarrayoptionalA list of instant messenger identifiers for this person.

job_titlestringoptionalThe person's job title.

label_idsarrayoptionalA list of label IDs to assign to this person.

marketing_statusstringoptionalMarketing opt-in status for the person, e.g. subscribed or unsubscribed.

notesstringoptionalFree-text notes about this person.

org_idnumberoptionalThe ID of the organization to link this person to.

owner_idnumberoptionalThe ID of the user who owns this person record.

phonesarrayoptionalA list of phone numbers for this person.

postal_addressobjectoptionalThe person's postal address.

visible_tonumberoptionalVisibility setting for the person. 1 = owner only, 3 = entire company.

pipedrivemcp_convertleadtodeal#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.3 params

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.

NameTypeRequiredDescription

idstringrequiredThe ID of the lead to convert.

pipeline_idintegeroptionalThe pipeline to place the new deal in.

stage_idintegeroptionalThe stage to place the new deal in.

pipedrivemcp_getactivities#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.15 params

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.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a previous response to fetch the next page.

deal_idnumberoptionalFilter activities by the ID of the linked deal.

donebooleanoptionalFilter by completion status. Set to true to retrieve only done activities, false for pending.

filter_idnumberoptionalThe ID of the filter to apply to the activities list.

idsstringoptionalComma-separated list of activity IDs to retrieve.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

lead_idstringoptionalFilter activities by the UUID of the linked lead.

limitnumberoptionalMaximum number of activities to return per page.

org_idnumberoptionalFilter activities by the ID of the linked organization.

owner_idnumberoptionalFilter activities by the ID of the user who owns them.

person_idnumberoptionalFilter activities by the ID of the linked person.

sort_bystringoptionalField to sort results by (e.g., due_date, add_time).

sort_directionstringoptionalSort direction: asc or desc.

updated_sincestringoptionalReturn activities updated after this date-time (ISO 8601 format).

updated_untilstringoptionalReturn activities updated before this date-time (ISO 8601 format).

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the activity to retrieve.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the deal to retrieve.

custom_fieldsstringoptionalComma-separated list of custom field keys to include.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalWhether to include deal label details.

include_option_labelsbooleanoptionalWhether to include labels for option-type custom fields.

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

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

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a previous response to fetch the next page.

custom_fieldsstringoptionalComma-separated list of custom field keys to include.

filter_idnumberoptionalThe ID of the filter to apply to the deals list.

idsstringoptionalComma-separated list of deal IDs to retrieve.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalWhether to include deal label details.

include_option_labelsbooleanoptionalWhether to include labels for option-type custom fields.

limitnumberoptionalMaximum number of deals to return per page.

org_idnumberoptionalFilter deals by the ID of the associated organization.

owner_idnumberoptionalFilter deals by the ID of the user who owns them.

person_idnumberoptionalFilter deals by the ID of the associated person.

pipeline_idnumberoptionalFilter deals by pipeline ID.

sort_bystringoptionalField to sort results by (e.g., add_time, update_time, value).

sort_directionstringoptionalSort direction: asc or desc.

stage_idnumberoptionalFilter deals by stage ID.

statusstringoptionalFilter deals by status (open, won, lost, deleted).

updated_sincestringoptionalReturn deals updated after this date-time (ISO 8601 format).

updated_untilstringoptionalReturn deals updated before this date-time (ISO 8601 format).

pipedrivemcp_getlead#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.1 param

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.

NameTypeRequiredDescription

idstringrequiredThe ID of the lead.

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

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

NameTypeRequiredDescription

conversion_idstringrequiredThe conversion ID returned by convertLeadToDeal.

idstringrequiredThe ID of the lead that was converted.

pipedrivemcp_getleads#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.8 params

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.

NameTypeRequiredDescription

filter_idintegeroptionalThe ID of the filter to use.

limitintegeroptionalThe number of leads to return per page.

organization_idintegeroptionalFilter leads linked to a specific organization.

owner_idintegeroptionalFilter leads by the ID of their owner.

person_idintegeroptionalFilter leads linked to a specific person.

sortstringoptionalField name and sort direction, e.g. 'add_time DESC'.

startintegeroptionalPagination start offset.

updated_sincestringoptionalReturn leads updated after this date/time in ISO 8601 format.

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the note.

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

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

NameTypeRequiredDescription

deal_idnumberoptionalFilter notes linked to a specific deal.

end_datestringoptionalThe date (YYYY-MM-DD) until which notes should be fetched.

lead_idstringoptionalFilter notes linked to a specific lead.

limitnumberoptionalThe number of results to return per page.

org_idnumberoptionalFilter notes linked to a specific organization.

person_idnumberoptionalFilter notes linked to a specific person.

pinned_to_deal_flagnumberoptionalFilter results by note-to-deal pinning state.

pinned_to_lead_flagnumberoptionalFilter results by note-to-lead pinning state.

pinned_to_organization_flagnumberoptionalFilter results by note-to-organization pinning state.

pinned_to_person_flagnumberoptionalFilter results by note-to-person pinning state.

pinned_to_project_flagnumberoptionalFilter results by note-to-project pinning state.

pinned_to_task_flagnumberoptionalFilter results by note-to-task pinning state.

project_idnumberoptionalFilter notes linked to a specific project.

sortstringoptionalField 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.

startnumberoptionalPagination start offset.

start_datestringoptionalThe date (YYYY-MM-DD) from which notes should be fetched.

task_idnumberoptionalFilter notes linked to a specific task.

updated_sincestringoptionalReturn notes updated after this date/time in RFC3339 format.

user_idnumberoptionalFilter notes by the ID of their owner (user).

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the organization.

custom_fieldsstringoptionalComma-separated list of custom field keys to include in the response.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalIf true, the response will include label names assigned to the organization.

include_option_labelsbooleanoptionalIf true, option field values will include their labels in addition to IDs.

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

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

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a previous response to retrieve the next page.

custom_fieldsstringoptionalComma-separated list of custom field keys to include in the response.

filter_idnumberoptionalThe ID of a saved filter to apply when fetching organizations.

idsstringoptionalComma-separated list of organization IDs to retrieve.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalIf true, the response will include label names assigned to each organization.

include_option_labelsbooleanoptionalIf true, option field values will include their labels in addition to IDs.

limitnumberoptionalMaximum number of organizations to return per page.

owner_idnumberoptionalFilter organizations by the ID of the owning user.

sort_bystringoptionalField name to sort results by, e.g. name or update_time.

sort_directionstringoptionalSort direction: asc or desc.

updated_sincestringoptionalReturn organizations updated after this ISO 8601 datetime.

updated_untilstringoptionalReturn organizations updated before this ISO 8601 datetime.

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the person.

custom_fieldsstringoptionalComma-separated list of custom field keys to include in the response.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalIf true, the response will include label names assigned to the person.

include_option_labelsbooleanoptionalIf true, option field values will include their labels in addition to IDs.

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

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

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a previous response to fetch the next page.

custom_fieldsstringoptionalComma-separated list of custom field keys to include.

deal_idnumberoptionalFilter persons by the ID of an associated deal.

filter_idnumberoptionalThe ID of the filter to apply to the persons list.

idsstringoptionalComma-separated list of person IDs to retrieve.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

include_labelsbooleanoptionalWhether to include person label details.

include_option_labelsbooleanoptionalWhether to include labels for option-type custom fields.

limitnumberoptionalMaximum number of persons to return per page.

org_idnumberoptionalFilter persons by the ID of their associated organization.

owner_idnumberoptionalFilter persons by the ID of the user who owns them.

sort_bystringoptionalField to sort results by (e.g., name, add_time, update_time).

sort_directionstringoptionalSort direction: asc or desc.

updated_sincestringoptionalReturn persons updated after this date-time (ISO 8601 format).

updated_untilstringoptionalReturn persons updated before this date-time (ISO 8601 format).

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the stage.

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

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

NameTypeRequiredDescription

cursorstringoptionalPagination cursor for the next page of results.

limitintegeroptionalThe number of results to return per page.

pipeline_idintegeroptionalIf provided, only stages belonging to this pipeline are returned.

sort_bystringoptionalThe field to sort by. Supported fields: id, update_time, add_time, order_nr.

sort_directionstringoptionalThe sorting direction. Supported values: asc, desc.

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

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

NameTypeRequiredDescription

termstringrequiredThe search term to look for. Minimum 2 characters.

cursorstringoptionalPagination cursor from a previous response to fetch the next page.

exact_matchbooleanoptionalWhether to match the search term exactly (case-insensitive).

fieldsstringoptionalComma-separated list of fields to search in (e.g., title, notes, custom_fields).

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

limitnumberoptionalMaximum number of results to return per page.

organization_idnumberoptionalFilter results to deals associated with this organization ID.

person_idnumberoptionalFilter results to deals associated with this person ID.

statusstringoptionalFilter results by deal status (open, won, lost).

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

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

NameTypeRequiredDescription

termstringrequiredThe search term to look for. Minimum 2 characters.

cursorstringoptionalPagination cursor from a previous response to retrieve the next page.

exact_matchbooleanoptionalIf true, only exact matches are returned. Default is false (partial match).

fieldsstringoptionalA comma-separated list of fields to search in. Defaults to all.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

limitintegeroptionalMaximum number of leads to return per page.

organization_idintegeroptionalWill filter leads by the provided organization ID. The upper limit of found leads associated with the organization is 2000.

person_idintegeroptionalWill filter leads by the provided person ID. The upper limit of found leads associated with the person is 2000.

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

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

NameTypeRequiredDescription

termstringrequiredThe search term to look for. Minimum 2 characters.

cursorstringoptionalPagination cursor for the next page of results.

exact_matchbooleanoptionalWhen true, only full exact matches are returned.

fieldsstringoptionalA comma-separated string of fields to search in.

limitintegeroptionalThe number of results to return per page.

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

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

NameTypeRequiredDescription

termstringrequiredThe search term to look for. Minimum 2 characters.

cursorstringoptionalPagination cursor for the next page of results.

exact_matchbooleanoptionalWhen true, only full exact matches are returned.

fieldsstringoptionalA comma-separated string of fields to search in.

include_fieldsstringoptionalComma-separated list of additional fields to include in the response.

limitnumberoptionalThe number of results to return per page.

organization_idnumberoptionalFilter results to persons associated with this organization.

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

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

NameTypeRequiredDescription

idnumberrequiredThe ID of the activity to update.

attendeesarrayoptionalList of calendar attendees for the activity.

busybooleanoptionalWhether the activity marks the user as busy in the calendar.

deal_idnumberoptionalThe ID of the deal to link this activity to.

donebooleanoptionalSet to true to mark the activity as completed.

due_datestringoptionalThe due date for the activity in YYYY-MM-DD format.

due_timestringoptionalThe due time for the activity in HH:MM format.

durationstringoptionalThe duration of the activity in HH:MM format.

lead_idstringoptionalThe UUID of the lead to link this activity to.

locationobjectoptionalThe location details for the activity.

notestringoptionalA private note for the activity.

org_idnumberoptionalThe ID of the organization to link this activity to.

owner_idnumberoptionalThe ID of the user to assign this activity to.

participantsarrayoptionalList of persons participating in the activity.

person_idnumberoptionalThe ID of the person to link this activity to.

prioritynumberoptionalThe priority level of the activity.

project_idnumberoptionalThe ID of the project to link this activity to.

public_descriptionstringoptionalA public note or description visible to all participants.

subjectstringoptionalThe subject/title of the activity.

typestringoptionalThe type of activity (e.g., call, meeting, task, email, deadline, lunch).

pipedrivemcp_updatedeal#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.22 params

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.

NameTypeRequiredDescription

idnumberrequiredThe ID of the deal to update.