Crm Lookup

Point this at HubSpot when you need to pull a specific contact by email, a company by domain, or walk the association graph from one record to its deals, tickets, or related contacts. It's read-only and leans on the CLI's batch-get to avoid spawning a process per record. The source shows you how to pick the right properties from live schemas, filter by token or exact match, and pipe through jq for substring narrowing when HubSpot's search operators aren't enough. If the lookup feeds a bulk update or merge, it hands off to the bulk-operations skill for the dry-run safety flow.

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

View on GitHub

Install

$ npx -y skills add hubspot/agent-cli-skills --skill crm-lookup --agent claude-code

Installs into .claude/skills of the current project.

Files

Source of truth

hubspot <command> --help is authoritative. Read bulk-operations/SKILL.md first — it owns JSONL piping, pagination, batch-get-via-stdin, and the safety flow for any write that comes after a lookup. This skill is read-only.

Pick properties from the live schema

Schemas drift. Run hubspot properties list --type <type> for the live set. First-pass --properties for a brief:

Object	`--properties`
contacts	`email,firstname,lastname,company,phone,lifecyclestage,hubspot_owner_id`
companies	`name,domain,industry,annualrevenue,numberofemployees,hubspot_owner_id`
deals	`dealname,amount,dealstage,closedate,hubspot_owner_id,hs_is_closed_won`
tickets	`subject,hs_pipeline_stage,hs_ticket_priority,hubspot_owner_id`

Contact ad/campaign attribution lives on hs_analytics_* (e.g. hs_analytics_source, hs_analytics_source_data_1/_2, hs_analytics_first_touch_converting_campaign, hs_analytics_last_touch_converting_campaign). Full list: hubspot properties list --type contacts | grep hs_analytics_.