How do I install the Hubspot skill?

Run npx skillmds@latest add javimosch/hubspot 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. 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?

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

Hubspot by javimosch — Agent Skill

Name: Hubspot
Author: javimosch

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.

javimosch 6714228 3.1 KB Updated Sep 17, 2026

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: hubspotdescription: 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.---# HubSpotInteract with HubSpot CRM directly via the HubSpot API (`api.hubapi.com`).## Setup (one-time)1. In HubSpot: Settings → Integrations → Private Apps → Create a private app2. 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 token4. Set environment variable: ``` HUBSPOT_TOKEN=pat-na1-... ```## Queries### Search contacts```bashpython3 /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```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list contacts --limit 20```### Get a specific object```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get contacts 12345python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get companies 67890python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get deals 11111```### List companies```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list companies --limit 20```### Search companies```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search companies --query "Acme"```### List deals```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list deals --limit 20```### Search deals```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search deals --query "enterprise"```### List tickets```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list tickets --limit 20```### Create a contact```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create contacts --email "new@example.com" --firstname "Jane" --lastname "Doe"```### Create a company```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com"```### Create a deal```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create deals --dealname "Enterprise Plan" --amount 50000 --pipeline default --dealstage appointmentscheduled```### Update an object```bashpython3 /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```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py associate contacts 12345 companies 67890```### List pipelines```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines dealspython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py pipelines tickets```### List owners```bashpython3 /mnt/skills/user/hubspot/scripts/hubspot_query.py owners```

Frequently asked questions