pipedrive-cli

A command-line interface for Pipedrive CRM. Manage persons, organizations, deals, leads, notes, activities, and more — all from the terminal.

Install

npm install -g pipedrive-cli

Or run directly with npx:

npx pipedrive-cli person search --term "John Doe"

Setup

Set your Pipedrive API token as an environment variable:

export PIPEDRIVE_API_TOKEN="your-api-token"

You can find your API token in Pipedrive under Settings > Personal preferences > API.

Usage

pipedrive <resource> <action> [options]

All commands output JSON by default. Add --pretty for human-readable output.

Persons

pipedrive person search --term "John Doe"
pipedrive person search --term "John" --fuzzy
pipedrive person get --id 123
pipedrive person create --name "Jane Smith" --email "jane@example.com" --phone "+1234567890" --org-id 456
pipedrive person update --id 123 --field "name=Jane Doe" --field "job_title=CEO"
pipedrive person delete --id 123
pipedrive person fields

Organizations

pipedrive org search --term "Acme Corp"
pipedrive org get --id 456
pipedrive org create --name "Acme Corp" --address "123 Main St" --website "https://acme.com"
pipedrive org update --id 456 --field "address=456 Oak Ave"
pipedrive org delete --id 456
pipedrive org fields

Deals

pipedrive deal list --org-id 456
pipedrive deal list --person-id 123 --status open
pipedrive deal create --title "New Partnership" --person-id 123 --org-id 456 --value 50000
pipedrive deal update --id 789 --field "value=75000" --field "status=won"

Leads

pipedrive lead list --person-id 123
pipedrive lead create --title "Potential Customer" --person-id 123 --org-id 456

Pipelines

pipedrive pipeline list

Users

pipedrive user list

Notes

pipedrive note create --content "Had a great call today" --person-id 123
pipedrive note list --person-id 123

Activities

pipedrive activity create --subject "Follow-up call" --type "call" --due-date "2025-03-15" --person-id 123
pipedrive activity list --person-id 123
pipedrive activity list --deal-id 789 --done

Custom Fields

The CLI auto-resolves human-readable field names for common custom fields:

• Person: --linkedin, --github, --twitter, --discord, --job-title
• Organization: --linkedin, --website, --industry

For other custom fields, use --field key=value. Run person fields or org fields to discover available field keys.

Claude Code Skill

This repo includes a SKILL.md that can be used as a Claude Code skill for AI-assisted CRM management.

License

MIT