# Hubspot

> Read and manage the HubSpot CRM: contacts, contact search, deals. Trigger phrases: hubspot, CRM, contacts, deals, pipeline.

- Skill: `anil-matcha/hubspot` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add anil-matcha/hubspot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anil-matcha/hubspot/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Anil-matcha (https://skillmd.com/u/anil-matcha)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/anil-matcha/hubspot

---


# HubSpot

## Purpose
Work with the user's HubSpot CRM: list contacts, search contacts, create contacts, and list deals. Use when the user mentions HubSpot, CRM, contacts, or their sales pipeline.

## Tooling
All commands go through `bin/hubspot.py`:

```bash
bin/hubspot.py contacts --limit 20                                  # list contacts
bin/hubspot.py search-contacts --query "acme"                       # search contacts
bin/hubspot.py create-contact --email jane@acme.com --firstname Jane --lastname Doe
bin/hubspot.py deals --limit 20                                     # list deals
```

## Auth
- Provider id: `hubspot` (credential is collected as `custom.hubspot`)
- Collection: API key via the secure credential flow (`credentials.request_api_access`): a HubSpot private app token (HubSpot Settings → Integrations → Private Apps), pasted once into the hosted form
- Enable these scopes on the private app: `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.objects.companies.read`, `crm.objects.deals.read`, `crm.objects.deals.write`
- Allowed hosts: `api.hubapi.com`
- Status check: `bin/hubspot.py contacts --limit 1` (must return a contacts list)

## Operating Rules
1. `create-contact` is a write: confirm the contact details with the user before creating, unless standing permission exists.
2. Reading (contacts, search-contacts, deals) needs no confirmation.
3. This skill is read-mostly by design; it ships no deal/contact deletion or update commands. Ask before adding any.
4. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/hubspot.py`). Do not print, log, or transmit the token value.

## Files
- SKILL.md
- bin/hubspot.py

## Maturity
🧪 Draft: written from HubSpot's public CRM API docs; not yet live-tested end-to-end.

