communication-history

Retrieve activity history (calls, emails, notes, meetings, tasks) for a CRM record and assemble pre-call briefs.

By hubspot · 1,314 installs

npx skills add hubspot/agent-cli-skills --skill communication-history

Source repository · Upstream listing

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, title, body, status, owner id} . timestamp is 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. All activity for a record Pass exactly one of contact , deal , company , ticket . Use type CALL EMAIL NOTE MEETING TASK to filter, limit N for the most recent N: Client side date filter ISO 8601 strings compare lexicographically. Compact timeline Pre call brief Four piped commands: contact + company + open deals + activity. Use batch objects get over stdin — never xargs I{} (see bulk operations/SKILL.md ). Transcripts Fetch the transcript for a single call by engagement ID: Dump all call transcripts to a file: Output shape: {"transcriptId":"...","engagementId":...,"transcriptSource":"...","utterances":[...],"createdAt":...} . The utterances array contains the speech content; it will be empty if no transcript was recorded or uploaded. Constraints limit max 100 and no after cursor — long histories can't be paged. body can be long; use the compact timeline for skimming.