Use aai-cli to inspect HubSpot CRM records, files, events, conversations, visitor identification, and custom channels.
npx skills add https://github.com/aai-labs/agent-barn --skill aai-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.
Take aai-labs/aai-hubspot from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.