Claude Skill

aai-hubspot

Use aai-cli to inspect HubSpot CRM records, files, events, conversations, visitor identification, and custom channels.

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download aai-labs-agent-barn-api_domains_agents_aai_cli_skills_bundled_skills_aai-hubspot-a013ede.zip · 1 KB

aai-labs/agent-barn 107 8 forks Apache-2.0 Updated 4h ago

Part of aai-labs/agent-barn — 11 skills

Install

skills CLI

npx skills add https://github.com/aai-labs/agent-barn/tree/main/api/domains/agents/aai_cli_skills/bundled/skills/aai-hubspot

Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install aai-labs-agent-barn@llmmart

Git git clone https://github.com/aai-labs/agent-barn.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole aai-labs/agent-barn collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

aai-cli HubSpot

Use this skill when working with HubSpot through aai-cli hubspot.

Before running commands, confirm the active profile or pass --profile. HubSpot profiles use auth_type = "hubspot_service_key" or auth_type = "hubspot_legacy_private_app" with token_secret.

HubSpot 401 and 403 errors include scope and auth-model remediation under details. Preserve that JSON when reporting failures. Custom channel commands are not supported for legacy private app tokens and return unsupported_auth before making a request.

Successful output is JSON on stdout. Errors are structured JSON on stderr. See the command reference for command shapes, scopes, and failure handling.

Files (agent-barn)

references

command-reference.md 2.2 KB

# aai-cli HubSpot Skill

Agent reference for the `aai-cli hubspot` command group.

## Profile

```toml
[profiles.hubspot-work]
provider = "hubspot"
auth_type = "hubspot_service_key" # or "hubspot_legacy_private_app"
token_secret = "hubspot.token"
```

## Common Commands

```bash
aai-cli hubspot health
aai-cli hubspot crm contacts list --limit 25
aai-cli hubspot crm companies get <id> --properties name,domain
aai-cli hubspot crm deals search --json query.json --limit 25
aai-cli hubspot files get <id> --hidden-or-deleted
aai-cli hubspot events occurrences list <event-type> --limit 25
aai-cli hubspot events custom send --json event.json
aai-cli hubspot conversations inboxes list
aai-cli hubspot conversations threads get <id>
aai-cli hubspot conversations visitor-identification tokens create --json token.json
aai-cli hubspot conversations custom-channels list
aai-cli hubspot request get /crm/v3/objects/contacts
```

## Scope Hints

- CRM objects: matching object scopes such as `crm.objects.contacts.read`, `crm.objects.companies.read`, `crm.objects.deals.read`, and `crm.objects.tickets.read`.
- Files: `files`; hidden/deleted reads may also need `files.ui_hidden.read`.
- Event occurrence reads: `business-intelligence`.
- Custom behavioral event sends: `analytics.behavioral_events.send`.
- Conversations reads: `conversations.read`; write flows usually also need `conversations.write`.
- Custom channels: `conversations.custom_channels.read` and `conversations.custom_channels.write`.
- Visitor identification tokens: `conversations.visitor_identification.tokens.create`.

## Error Handling

HubSpot auth failures preserve the provider response under `details.provider` and add `details.auth_type`, `details.endpoint`, `details.required_scopes`, and `details.remediation`.

Custom channel endpoints are not supported for legacy private app tokens. Use a supported HubSpot auth model for those commands.

## Pagination

List and search commands follow HubSpot's `paging.next.after` cursor and aggregate pages up to `--limit`, preserving the provider `results`/`paging` response shape. Use `--after` (or `after` in a search JSON body) to resume from a cursor. The `_aai.pagination` metadata reports remaining continuation and a suggested `next_command`.

SKILL.md 892 B

---
name: aai-hubspot
description: Use aai-cli to inspect HubSpot CRM records, files, events, conversations, visitor identification, and custom channels.
---

# aai-cli HubSpot

Use this skill when working with HubSpot through `aai-cli hubspot`.

Before running commands, confirm the active profile or pass `--profile`. HubSpot profiles use `auth_type = "hubspot_service_key"` or `auth_type = "hubspot_legacy_private_app"` with `token_secret`.

HubSpot `401` and `403` errors include scope and auth-model remediation under `details`. Preserve that JSON when reporting failures. Custom channel commands are not supported for legacy private app tokens and return `unsupported_auth` before making a request.

Successful output is JSON on stdout. Errors are structured JSON on stderr. See [the command reference](references/command-reference.md) for command shapes, scopes, and failure handling.