Deals

Command	Description
`deals [flags]`	List deals
`deal <id>`	Get deal details
`deal-create <title> [flags]`	Create deal
`deal-update <id> <field> <value>`	Update deal
`deal-delete <id>`	Delete deal

Deal flags:

--limit <n> - Max results (default: 50)
--start <n> - Offset for pagination
--all - Fetch ALL results with auto-pagination (saves to file if large)
--status <open\|won\|lost\|all> - Filter by status (default: open)
--pipeline <id> - Filter by pipeline
--stage <id> - Filter by stage
--user <id> - Filter by owner
--org <id> - Filter by organization
--person <id> - Filter by person

Create flags:

--org <id> - Link to organization
--person <id> - Link to person
--pipeline <id> - Pipeline ID
--stage <id> - Stage ID
--value <amount> - Deal value
--currency <code> - Currency (e.g., USD, EUR)

Update fields: title, value, currency, status, stage_id, pipeline_id, person_id, org_id, expected_close_date

Persons (Contacts)

Command	Description
`persons [flags]`	List persons
`person <id>`	Get person details
`person-create <name> [flags]`	Create person
`person-update <id> <field> <value>`	Update person
`person-delete <id>`	Delete person

Person flags:

--limit <n> - Max results (default: 50)
--start <n> - Offset for pagination
--all - Fetch ALL results with auto-pagination
--org <id> - Filter by organization

Create flags:

--email <email> - Email address
--phone <phone> - Phone number
--org <id> - Link to organization

Update fields: name, email, phone, org_id

Organizations

Command	Description
`orgs [flags]`	List organizations

Organization flags:

--limit <n> - Max results (default: 50)
--start <n> - Offset for pagination
--all - Fetch ALL results with auto-pagination | org <id> | Get organization details | | org-create <name> | Create organization | | org-update <id> <field> <value> | Update organization | | org-delete <id> | Delete organization |

Update fields: name, address

Activities

Command	Description
`activities [flags]`	List activities
`activity <id>`	Get activity details
`activity-create <type> <subject> [flags]`	Create activity
`activity-done <id>`	Mark activity as done
`activity-delete <id>`	Delete activity

Activity flags:

--limit <n> - Max results (default: 50)
--start <n> - Offset for pagination
--all - Fetch ALL results with auto-pagination
--from <YYYY-MM-DD> - Filter by start date
--to <YYYY-MM-DD> - Filter by end date
--date <YYYY-MM-DD> - Filter by specific date
--type <type> - Filter by type (call, meeting, task, deadline, email, lunch)
--done <0\|1> - Filter by done status
--user <id> - Filter by user
--deal <id> - Filter by deal
--person <id> - Filter by person

Create flags:

--deal <id> - Link to deal
--person <id> - Link to person
--org <id> - Link to organization
--due <date> - Due date (YYYY-MM-DD)
--time <time> - Due time (HH:MM)
--duration <mins> - Duration in minutes
--note <text> - Activity note

Pipelines & Stages

Command	Description
`pipelines`	List all pipelines
`pipeline <id>`	Get pipeline with stages
`stages <pipeline-id>`	List stages in a pipeline

Notes

Command	Description
`notes <entity> <id>`	List notes (entity: deal, person, org)
`note-create <entity> <id> <content>`	Add note to entity

Search

Command	Description
`search <query> [--type <type>]`	Search across Pipedrive

Search types: deal, person, organization, product, file

Examples

# My info
~/.claude/skills/pipedrive/pipedrive me

# List open deals
~/.claude/skills/pipedrive/pipedrive deals

# List won deals
~/.claude/skills/pipedrive/pipedrive deals --status won

# Get deal details
~/.claude/skills/pipedrive/pipedrive deal 123

# Create a deal
~/.claude/skills/pipedrive/pipedrive deal-create "New Project" --value 5000 --org 456

# Update deal value
~/.claude/skills/pipedrive/pipedrive deal-update 123 value 10000

# List contacts
~/.claude/skills/pipedrive/pipedrive persons --limit 20

# Create contact
~/.claude/skills/pipedrive/pipedrive person-create "John Doe" --email john@example.com --phone "+1234567890"

# List activities for today
~/.claude/skills/pipedrive/pipedrive activities --done 0

# Create a call activity
~/.claude/skills/pipedrive/pipedrive activity-create call "Follow up call" --deal 123 --due 2024-01-15

# Mark activity done
~/.claude/skills/pipedrive/pipedrive activity-done 789

# Search for deals
~/.claude/skills/pipedrive/pipedrive search "acme" --type deal

# Add note to deal
~/.claude/skills/pipedrive/pipedrive note-create deal 123 "Called and discussed pricing"

# Fetch ALL deals (auto-paginated, saves to file if large)
~/.claude/skills/pipedrive/pipedrive deals --all --status all

# Fetch all deals for a specific user
~/.claude/skills/pipedrive/pipedrive deals --user 123 --all

Large Results

When using --all, if the result exceeds 50KB it will be saved to a file and the command returns:

{"success":true,"total_items":509,"saved_to_file":"/tmp/pipedrive-results/result_XXX.json","message":"..."}

Process the file with jq or python:

# Filter deals with >10 activities
cat /tmp/pipedrive-results/result_XXX.json | python3 -c "
import json, sys
data = json.load(sys.stdin)
for d in data['data']:
    if d.get('activities_count', 0) > 10:
        print(f\"{d['title']}: {d['activities_count']} activities\")
"

Command	Description
`auth`	Setup OAuth2 authentication
`status`	Check authentication status

pipedrive

Pipedrive Integration

Commands

Setup

Account