crm-lookup

The crm-lookup skill provides commands to search and retrieve HubSpot CRM records, including contacts, companies, deals, and tickets. It supports batch lookups, exact-match filtering, token-based searching, and association traversal using the HubSpot CLI.

360
Installs
5
Use cases
9/10
Quality

Is crm-lookup safe to install?

Review the source first

Review the source first: our audit of crm-lookup's source files found 5 shell commands, 0 external URLs, no file writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill executes shell commands via the HubSpot CLI to interact with external CRM data.

How we audit skills: our security review methodology.

Who is this skill for?

Developers and operators managing HubSpot CRM data via command-line interfaces.

What can you do with it?

  • Retrieve specific CRM records by ID, email, or domain.
  • Search for deals using partial name matching.
  • List associated records for a given contact or company.
  • Filter CRM data client-side using jq.
  • Fetch properties for multiple records in a single batch operation.

How good is this skill?

Quality score: 9/10. The documentation is clear and provides specific command examples. It correctly references external dependencies for pagination and write safety.

What does the skill file contain?

SKILL.md
## Source of truth

`hubspot <command> --help` is authoritative. Read [`bulk-operations/SKILL.md`](../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,an...

Frequently asked questions

Is this skill read-only?

Yes, this skill is read-only. Any write operations must follow the safety flow defined in the bulk-operations skill.

How do I perform a substring search?

The CLI supports token-based matching with the ~ operator. For substring filtering, pipe the search results to jq.

What is the limit for batch lookups?

The skill supports up to 100 IDs in a single batch call.

Data sourced from hubspot/agent-cli-skills on GitHub. Install counts from skills.sh. The summary and security audit are derived from the skill's source files: every command and URL listed appears verbatim in the source.

Related skills