pipedrive-mcp

Full-featured Pipedrive MCP server for Claude Desktop. Supports deals, leads, persons, organizations, notes, activities, pipelines, and more — all controllable via natural language.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "pipedrive": {
      "command": "npx",
      "args": ["-y", "pipedrive-mcp"],
      "env": {
        "PIPEDRIVE_API_TOKEN": "your_api_token_here",
        "PIPEDRIVE_COMPANY_DOMAIN": "your_company_subdomain"
      }
    }
  }
}

Where to find your credentials:

• PIPEDRIVE_API_TOKEN: Pipedrive → Settings → Personal preferences → API → Your personal API token
• PIPEDRIVE_COMPANY_DOMAIN: Just the subdomain of your Pipedrive URL. If your URL is https://mycompany.pipedrive.com, use mycompany

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

After saving, restart Claude Desktop.

---

Available Tools

Deals (6 tools)

Tool	Description
pipedrive_list_deals	List deals with advanced filters — status, stage, pipeline, owner, value range, days back, title search
pipedrive_get_deal	Get full deal details including resolved custom fields
pipedrive_create_deal	Create a new deal
pipedrive_update_deal	Update deal fields (title, value, stage, status, owner, etc.)
pipedrive_delete_deal	Permanently delete a deal
pipedrive_search_deals	Search deals by keyword

Leads (8 tools)

Tool	Description
pipedrive_list_leads	List leads with optional filters (owner, person, org, archived status)
pipedrive_get_lead	Get full lead details by UUID
pipedrive_create_lead	Create a new lead with value, labels, and linked contacts
pipedrive_update_lead	Update lead fields or archive/unarchive
pipedrive_delete_lead	Permanently delete a lead
pipedrive_search_leads	Search leads by keyword
pipedrive_get_lead_labels	List all available lead labels (for use with label_ids)
pipedrive_get_lead_sources	List all available lead sources

Persons / Contacts (6 tools)

Tool	Description
pipedrive_list_persons	List contacts with pagination
pipedrive_get_person	Get full contact details including resolved custom fields
pipedrive_create_person	Create a new contact with email, phone, and org
pipedrive_update_person	Update contact fields
pipedrive_delete_person	Permanently delete a contact
pipedrive_search_persons	Search contacts by name, email, or phone

Organizations (5 tools)

Tool	Description
pipedrive_list_organizations	List organizations with pagination
pipedrive_get_organization	Get full org details including resolved custom fields
pipedrive_create_organization	Create a new organization
pipedrive_delete_organization	Permanently delete an organization
pipedrive_search_organizations	Search organizations by name or address

Notes (2 tools)

Tool	Description
pipedrive_list_notes	List notes filtered by deal, person, or organization
pipedrive_add_note	Add a note to a deal, contact, or organization

Activities (3 tools)

Tool	Description
pipedrive_list_activities	List activities filtered by deal, person, org, or completion status
pipedrive_create_activity	Create a new activity (call, meeting, email, task, etc.)
pipedrive_update_activity	Update or mark an activity as done

Pipelines & Stages (2 tools)

Tool	Description
pipedrive_list_pipelines	List all sales pipelines
pipedrive_list_stages	List stages, optionally filtered by pipeline

Users (1 tool)

Tool	Description
pipedrive_get_users	List all users with ID, name, email, and active status

Search (1 tool)

Tool	Description
pipedrive_search_all	Global search across all item types simultaneously

Total: 34 tools

---

Available Prompts

Pre-built conversation starters available in Claude Desktop:

Prompt	Description
list-all-deals	Complete overview of all deals organized by status with total pipeline value
list-all-persons	Full contact list grouped by organization
analyze-deals	Deep pipeline analysis: values, stages, win rates, overdue deals, top deals by owner
analyze-contacts	Contact and org overview with deal activity, engagement stats, cold prospects
find-high-value-deals	Prioritized list of highest-value open deals with activity flags
analyze-leads	Leads analysis: volume, owners, labels, values, upcoming close dates
compare-pipelines	Side-by-side comparison of all pipelines with conversion rates

---

Key Features

• Rate limiting — Bottleneck-based rate limiting stays safely under Pipedrive's API limits (70 req/2s)
• Custom fields — get_deal, get_person, get_organization automatically resolve custom field hash keys to human-readable names and option labels
• Full leads CRUD — Complete lead lifecycle: create, read, update, delete, search, label, archive
• Advanced deal filtering — Filter by pipeline, value range, age, title keyword on top of standard filters
• Delete operations — Permanently delete deals, leads, persons, and organizations
• Global search — Search across all CRM record types in one call
• Structured responses — All tools return both markdown text and structured JSON data

---

Requirements

• Node.js 18 or higher
• A Pipedrive account with API access
• Claude Desktop

---

Development (local build)

git clone <repo>
cd pipedrive-mcp-server
npm install
npm run build

# Run locally
PIPEDRIVE_API_TOKEN=xxx PIPEDRIVE_COMPANY_DOMAIN=mycompany node dist/index.js

For local use, update claude_desktop_config.json to point to the built file:

{
  "mcpServers": {
    "pipedrive": {
      "command": "node",
      "args": ["/absolute/path/to/pipedrive-mcp-server/dist/index.js"],
      "env": {
        "PIPEDRIVE_API_TOKEN": "your_token",
        "PIPEDRIVE_COMPANY_DOMAIN": "your_subdomain"
      }
    }
  }
}

---

Publishing to npm

npm login
npm publish

After publishing, anyone can use it via the npx config shown at the top — no local installation needed.