Connect Pipedrive to Claude Code
Search and update deals, people, organizations, activities and notes in the Pipedrive CRM. Add Toolspoke to Claude Code once and it can use 14 Pipedrive actions. Your Pipedrive credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Pipedrive and connect it
Add Pipedrive to a project in your Toolspoke workspace.
API token. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API token
- Pipedrive → your profile menu → Personal preferences → API → Your personal API token. The token carries your own user's permissions, so what this connection can see and change is what you can see and change. It is sent as an x-api-token header, never in the URL.
Choose what Claude Code may do
All 14 actions start on. Switch off any of the 5 actions that change something in Pipedrive, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Pipedrive actions that only read, so they are safe to try first.
- Search deals by free text
- Fetch one deal in full, by the id search_deals returns
- Search people by name, email address or phone number
- Search organizations by name or address
What Claude Code can do in Pipedrive
9 actions read and 5 write.
Reads
Search deals
Search deals by free text. `term` is required and must be at least two characters. Pipedrive has no "list every deal" search, so start from a name, a company or a keyword. Narrow with person_id or organization_id when you already know who the deal belongs to, and with status to separate open work from won and lost. Returns deal ids; pass one to get_deal for the whole record. Pages by cursor rather than by offset.
Get deal
Fetch one deal in full, by the id search_deals returns. Ask for custom_fields when the account keeps anything important in them, and for include_option_labels when you want a dropdown's label rather than its numeric id. The returned stage_id is an internal id, which list_stages translates into a name.
Search persons
Search people by name, email address or phone number. `term` is required and must be at least two characters. Set `fields` to "email" to look somebody up by address without matching their name as well. Returns person ids and the matching contact details; pass an id to get_person for the whole record.
Get person
Fetch one person in full, their name, every email address and phone number on the record, their employer, owner and custom fields. Takes the id search_persons returns.
Search organizations
Search organizations by name or address. `term` is required and must be at least two characters. Returns organization ids; use one as org_id on a deal or a person, or as organization_id when narrowing search_deals or search_persons. Unlike the deal and person searches this one takes no owner filter and no include_fields.
List activities
List activities. Pipedrive's calls, meetings, emails and tasks, newest change first. Narrow by deal_id, person_id, org_id or owner_id to see one thing's history, and by done to separate what is outstanding from what is finished. Note what v2 does not have: there is no start_date or end_date window any more, so bound a query with updated_since and updated_until, or sort by due_date and page.
List pipelines
List the account's pipelines, each with its id and name. A pipeline id is what create_deal and update_deal take, and it is also the filter list_stages needs. This is account configuration, it holds no deal and no person.
List stages
List pipeline stages with their ids, names and order. This is the translation table between what a person says and what the API takes: "Negotiation" is a name, and create_deal and update_deal only accept the numeric stage_id. Pass pipeline_id to see one pipeline's stages rather than every stage in the account. Account configuration, no deal and no person appears here.
List users
List the account's own Pipedrive users, with their ids, names and email addresses. Call it to turn a colleague's name into the owner_id that create_deal, update_deal, create_activity and add_note take. These are the caller's own colleagues rather than anybody the account sells to, which is why the response stays in the audit log. It is the connection check as well, because it takes no parameters at all and reads no record. This is the second of the two operations still on API v1. Pipedrive built no v2 user list.
Writes
Create deal
Create a deal. Only `title` is required; everything else is optional and Pipedrive fills in the account's defaults. pipeline_id and stage_id are internal ids rather than the names shown in the UI, call list_pipelines and list_stages first and copy the ids from there. owner_id is the Pipedrive user the deal belongs to, from list_users. These are the v2 field names: it is org_id and owner_id, not the v1 organization_id and user_id.
Update deal
Change fields on an existing deal, this is how a deal moves to another stage, gets re-priced, or is marked won or lost. Only the fields you send are touched. v2 uses PATCH here; v1's PUT is gone. stage_id must be an internal id from list_stages, not a stage name. This cannot delete the deal.
Create person
Create a person. Nothing is strictly required, but a record with no name is not useful. Note the v2 shape for contact details: `emails` and `phones` are lists of objects, each {"value": "[email protected]", "label": "work", "primary": true}, v1's single `email` and `phone` strings are gone. Search first; Pipedrive will happily create a second record for somebody who is already there.
Create activity
Schedule an activity, a call, a meeting, a task, and attach it to a deal, a person or an organization. `type` is the account's own activity type key from its settings, e.g. "call", "meeting", "task"; "call" and "meeting" exist in every account. due_date is a plain date and due_time a 24-hour clock time, both in the account's time zone. This is internal scheduling only: Pipedrive's calendar attendee list, which mails an invitation to an outside address when calendar sync is switched on, is deliberately not offered here, so nothing this operation does is visible to anybody outside the account.
Add note
Log a note against a deal, a person or an organization. The note appears on that record's timeline for the account's own users and is not sent to anybody outside it, which is why this is a write. `content` is HTML, so line breaks want <br> rather than \n, and Pipedrive sanitises what it is given. Pipedrive requires at least one of deal_id, person_id, org_id or lead_id, a note attached to nothing is refused. This is one of the two operations in this connector still on API v1: Pipedrive never built a v2 for notes, and the v1 endpoint remains supported.
Pipedrive in Claude Code: questions
Does Claude Code see my Pipedrive credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Pipedrive?
Yes. Each of the 14 actions can be switched off for a project. Turn off the 5 that change something and Claude Code can only read.
Will 14 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Pipedrive action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Pipedrive call does not run in a sandbox, so it bills nothing.
Pipedrive in your other apps
More crm toolkits for Claude Code
Try Pipedrive in Claude Code
Free to start, and tool calls cost nothing on any plan.