How do I install the Hubspot skill?

Run npx skillmds@latest add dvcrn/hubspot-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hubspot safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hubspot?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hubspot free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hubspot?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hubspot by dvcrn — Agent Skill

Name: Hubspot
Rating: 4.2 (5 reviews)
Author: dvcrn

Hubspot

Query and manage HubSpot CRM data via the HubSpot API. Use when you need to search or manage contacts, companies, deals, tickets, or pipelines. Supports creating, updating, and associating CRM objects. Calls api.hubapi.com directly with no third-party proxy.

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

HubSpot

Interact with HubSpot CRM directly via the HubSpot API (api.hubapi.com).

Setup (one-time)

In HubSpot: Settings → Integrations → Private Apps → Create a private app
Give it scopes: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.deals.read, crm.objects.deals.write, tickets
Copy the access token
Set environment variable:
```
HUBSPOT_TOKEN=pat-na1-...
```

Queries

Search contacts

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --query "john"
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --email "john@example.com"

List contacts

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list contacts --limit 20

Get a specific object

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get contacts 12345
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get companies 67890
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get deals 11111

List companies

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list companies --limit 20

Search companies

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search companies --query "Acme"

List deals

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list deals --limit 20

Search deals

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search deals --query "enterprise"

List tickets

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list tickets --limit 20

Create a contact

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create contacts --email "new@example.com" --firstname "Jane" --lastname "Doe"

Create a company

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com"

Create a deal

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create deals --dealname "Enterprise Plan" --amount 50000 --pipeline default --dealstage appointmentscheduled

Update an object

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update contacts 12345 --email "new@example.com" --phone "+1234567890"
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update deals 11111 --dealstage closedwon --amount 75000

Associate objects

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py associate contacts 12345 companies 67890

List pipelines

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines deals
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines tickets

List owners

python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py owners

---name: hubspot-3description: Query and manage HubSpot CRM data via the HubSpot API. Use when you need to search or manage contacts, companies, deals, tickets, or pipelines. Supports creating, updating, and associating CRM objects. Calls api.hubapi.com directly with no third-party proxy.--- # HubSpot Interact with HubSpot CRM directly via the HubSpot API (`api.hubapi.com`). ## Setup (one-time) 1. In HubSpot: Settings → Integrations → Private Apps → Create a private app 2. Give it scopes: `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.objects.companies.read`, `crm.objects.companies.write`, `crm.objects.deals.read`, `crm.objects.deals.write`, `tickets` 3. Copy the access token 4. Set environment variable: ``` HUBSPOT_TOKEN=pat-na1-... ``` ## Queries ### Search contacts ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --query "john" python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --email "john@example.com" ``` ### List contacts ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list contacts --limit 20 ``` ### Get a specific object ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get contacts 12345 python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get companies 67890 python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get deals 11111 ``` ### List companies ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list companies --limit 20 ``` ### Search companies ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search companies --query "Acme" ``` ### List deals ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list deals --limit 20 ``` ### Search deals ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search deals --query "enterprise" ``` ### List tickets ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list tickets --limit 20 ``` ### Create a contact ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create contacts --email "new@example.com" --firstname "Jane" --lastname "Doe" ``` ### Create a company ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com" ``` ### Create a deal ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create deals --dealname "Enterprise Plan" --amount 50000 --pipeline default --dealstage appointmentscheduled ``` ### Update an object ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update contacts 12345 --email "new@example.com" --phone "+1234567890" python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py update deals 11111 --dealstage closedwon --amount 75000 ``` ### Associate objects ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py associate contacts 12345 companies 67890 ``` ### List pipelines ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines deals python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines tickets ``` ### List owners ```bash python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py owners ```

Frequently asked questions