Communication History

Pulls calls, emails, notes, meetings, and tasks from HubSpot for any contact, deal, company, or ticket. The pre-call brief pattern is the standout: pipe together contact details, associated company, open deals, and recent activity into a single view before hopping on a call. Activities come back as flat JSON rows with timestamp, type, title, and body, newest first. You can filter by activity type, grab the last N items, or do client-side date filtering since the ISO timestamps sort lexicographically. It also fetches call transcripts by engagement ID or dumps them in bulk, though you're capped at 100 records per list with no cursor pagination for longer histories.

skills.sh installs: 1.8K
GitHub stars: 29
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add hubspot/agent-cli-skills --skill communication-history --agent claude-code

Installs into .claude/skills of the current project.

Files

Read bulk-operations/SKILL.md first — JSONL piping, batch read, and jq reshape patterns (resources/json-patterns.md) apply. hubspot activities list --help is the source of truth.

Output shape

activities list returns one flat row per activity, sorted newest-first: {id, type, timestamp, lastModified, title, body, status, owner_id}. timestamp and lastModified are ISO 8601; type is CALL|EMAIL|NOTE|MEETING|TASK. Different from the raw hs_call_* / hs_timestamp (Unix ms) on the underlying objects — fetch those with hubspot objects get --type calls if needed.

For point-in-time filtering compare lastModified (hs_lastmodifieddate, when the body was last edited), not timestamp (engagement creation time) — otherwise you include content edited after your cutoff.

All activity for a record

Pass exactly one of --contact, --deal, --company, --ticket (or --type <object_type> --record <id> for any other object type). Use --activity-type CALL|EMAIL|NOTE|MEETING|TASK to filter by activity kind, --limit N for the most recent N. Note --type is now the object-type flag, not the activity-kind filter:

SKILL.md on GitHub