# Hubspot Companies

> Use when the user wants to search, read, create, update, or delete HubSpot CRM companies (accounts, organizations, businesses) via the `hubspot` command-line tool.

- **Type:** Skill
- **Install:** `agentstack add skill-dipankar-hubspot-cli-hubspot-companies`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dipankar](https://agentstack.voostack.com/s/dipankar)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dipankar](https://github.com/dipankar)
- **Source:** https://github.com/dipankar/hubspot-cli/tree/main/assets/skills/hubspot-companies

## Install

```sh
agentstack add skill-dipankar-hubspot-cli-hubspot-companies
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# HubSpot Companies (via `hubspot` CLI)

Companies represent organizations. Contacts and deals associate to them. All commands return `{"success": true, "data": ...}`.

## Auth

Set `HUBSPOT_ACCESS_TOKEN` in the environment (HubSpot private-app token). Optional: `--profile ` for multi-portal setups.

## Canonical commands

| Intent | Command |
| --- | --- |
| List | `hubspot crm companies list --limit 20` |
| Get by ID | `hubspot crm companies get 12345` |
| Create | `hubspot crm companies create --name "Acme Inc" --domain acme.com` |
| Create from JSON | `hubspot crm companies create --properties '{"name":"Acme","industry":"SOFTWARE"}'` |
| Update | `hubspot crm companies update 12345 --properties '{"industry":"RETAIL"}'` |
| Delete | `hubspot crm companies delete 12345 --yes` |
| Search by domain | `hubspot crm companies search --query "domain:acme.com"` |
| Filtered search | `hubspot crm companies search --filter-groups '[{"filters":[{"propertyName":"numberofemployees","operator":"GT","value":"100"}]}]'` |
| Batch create | `hubspot crm companies batch-create --inputs '[{"properties":{"name":"A"}},{"properties":{"name":"B"}}]'` |
| Discover properties | `hubspot discover properties companies` |

## Associating contacts and deals

```bash
# List contacts associated to company 12345
hubspot crm associations list companies 12345 contacts

# Link company 12345 to contact 67890
hubspot crm associations create companies 12345 contacts 67890

# Remove the link
hubspot crm associations delete companies 12345 contacts 67890
```

## Common properties

`name`, `domain`, `industry`, `numberofemployees`, `annualrevenue`, `phone`, `city`, `state`, `country`, `hubspot_owner_id`, `lifecyclestage`. Use `hubspot discover properties companies` for the full list.

## Output / errors

Shape matches the contacts skill: `{success, data, paging}` envelope. Error codes: `AUTH_ERROR (3)`, `VALIDATION_ERROR (5)`, `NOT_FOUND (6)`, `RATE_LIMIT (7)`, `SERVER_ERROR (8)`.

## Scopes

- Read: `crm.objects.companies.read`
- Write: `crm.objects.companies.write`

## Tips

- The `domain` property is the most reliable dedupe key. Before creating, search: `hubspot crm companies search --query "domain:"`.
- Use `list` with `--properties name,domain,industry` to keep list payloads small.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dipankar](https://github.com/dipankar)
- **Source:** [dipankar/hubspot-cli](https://github.com/dipankar/hubspot-cli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dipankar-hubspot-cli-hubspot-companies
- Seller: https://agentstack.voostack.com/s/dipankar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.