Knowledge Base

Knowledge Base/Pipedrive MCP/Pipedrive MCP setup/Pipedrive MCP tools

Topics

Pipedrive MCP tools

Yssel Salas

Last updated: November 4, 2026

In MCP, tools are the actions that an AI assistant can perform in Pipedrive. Each tool is designed for a specific task, such as creating a deal, retrieving a contact's details or updating an activity.

When an AI assistant connects to Pipedrive through MCP, it can use these tools to access information and perform actions on your behalf, based on the permissions you grant.

Tool names follow a consistent naming pattern:

`getX` (plural)	Fetch a list
`getX` (singular)	Fetch one specific record
`addX`	Create a new record
`updateX`	Edit an existing record
`searchX`	Find records by keyword or criteria

Pipedrive-specific MCP tools

Activities

Tool	Action	Use case
`getActivities`	Fetch a list of activities	"Show me all calls scheduled this week"
`getActivity`	Fetch one specific activity	"Get details of this particular meeting"
`addActivity`	Create a new activity	"Schedule a follow-up call with this contact"
`updateActivity`	Edit an existing activity	"Mark this call as done" or "Reschedule it"

Deals

Tool	Action	Use case
`getDeals`	Fetch a list of deals	"Show me all open deals in my pipeline"
`getDeal`	Fetch one specific deal	"Get details of the Acme deal"
`addDeal`	Create a new deal	"Create a deal for this new prospect"
`updateDeal`	Edit an existing deal	"Move this deal to the next stage" or "Update the value"
`searchDeals`	Search deals by keyword	"find all deals mentioning enterprise"

Persons

Tool	Action
`getPersons`	Fetch a list of contacts
`getPerson`	Fetch one specific contact
`addPerson`	Create a new contact
`updatePerson`	Edit an existing contact
`searchPersons`	Find contacts by name, email or other criteria

Organizations

Tool	Action
`getOrganizations`	Fetch a list of organizations
`getOrganization`	Fetch one specific organization
`addOrganization`	Create a new organization
`updateOrganization`	Edit an existing organization
`searchOrganization`	Search organizations by name or keyword

Leads

Tool	Action
`getLeads`	Fetch a list of leads
`getLead`	Fetch one specific lead
`addLead`	Create a new lead
`updateLead`	Edit an existing lead
`searchLeads`	Find leads by keyword or criteria
`convertLeadToDeal`	Convert a lead into a deal
`getLeadConversionStatus`	Check whether a lead has been converted and to which deal

Products

Tool	Action
`getProducts`	Fetch a list of products
`getProduct`	Fetch one specific product
`addProduct`	Create a new product
`updateProduct`	Edit an existing product
`searchProduct`	Search products by name or keyword

Pipeline

Tool	Action
`getStages`	Fetch all stages in a pipeline
`getStage`	Fetch details of one specific stage

Notes

Tool	Action
`getNotes`	Fetch the list of notes
`getNote`	Fetch details of one specific note
`addNote`	Adds a note attached to a deal/lead/contact/organization
`updateNote`	Updates a specific note by its ID

Context

If your permissions don't cover part of this information, the tool skips that part and returns the rest.

Tool	Action
`getAccountContext`	Fetch account details: your user, pipelines and their stages, custom fields for deals, persons, organizations, products and activities, and the other users in your company

Emails

Note: These tools require a connected email sync.

Tool	Action
`getMailThreads`	Fetch a list of email threads
`getMailThread`	Fetch one specific email thread
`getMailThreadMessages`	Fetch all messages in an email thread
`getMailMessage`	Fetch one specific email message
`updateMailThreadDetails`	Edit the details of an existing email thread
`getDealMailMessages`	Fetch the email messages linked to a deal
`getPersonMailMessages`	Fetch the email messages linked to a contact
`getOrganizationMailMessages`	Fetch the email messages linked to an organization

Use cases:

View the full email history for a deal, person or organization before a call, so you know what was last said
Find a thread, read every message in it and summarize what's pending or who still needs to reply
Update thread details, such as linking a thread to a deal or person, without opening the mail tab

Projects

Note: The Projects feature is part of the Projects add-on.

Tool	Action
`getProjects`	Fetch a list of projects
`getProject`	Fetch one specific project
`addProject`	Create a new project
`updateProject`	Edit an existing project
`searchProjects`	Find projects by keyword or criteria