← Back to Skills Marketplace
Native HubSpot
by
codeninja23
· GitHub ↗
· v1.0.1
742
Downloads
18
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install native-hubspot
Description
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 crea...
README (SKILL.md)
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 "[email protected]"
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 "[email protected]" --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 "[email protected]" --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
Usage Guidance
This skill is coherent: it needs your HubSpot private-app token and uses python3 to call api.hubapi.com. Before installing, ensure you: (1) create a HubSpot private app with only the minimum scopes you need, (2) treat the HUBSPOT_TOKEN as a sensitive secret and only supply it to skills you trust, (3) review the full script locally (the provided listing was truncated in the prompt) to confirm there are no unexpected network calls or data exfiltration, and (4) consider using a token with limited write scopes or a token you can rotate if you're concerned.
Capability Analysis
Type: OpenClaw Skill
Name: native-hubspot
Version: 1.0.1
The skill bundle is benign. It provides a direct interface to the HubSpot CRM API, as clearly stated in `SKILL.md` and `README.md`. The `scripts/hubspot_query.py` script uses standard Python libraries (`urllib.request`, `json`, `os`) to interact solely with `https://api.hubapi.com`, authenticating via the `HUBSPOT_TOKEN` environment variable. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution (e.g., `curl|bash`, `eval`), persistence mechanisms, or prompt injection attempts against the AI agent. The broad read/write permissions requested are necessary for the skill's stated purpose of managing CRM data.
Capability Assessment
Purpose & Capability
Name and description state direct HubSpot API access and the package requires python3 plus a HUBSPOT_TOKEN — both are expected for a simple CLI tool that calls api.hubapi.com.
Instruction Scope
SKILL.md instructs creating a HubSpot private app, setting HUBSPOT_TOKEN, and running the included Python script. The instructions do not ask the agent to read unrelated files or transmit data to other endpoints; they target only api.hubapi.com.
Install Mechanism
No install spec (instruction-only) and the code uses only Python standard library; nothing is downloaded or written to disk outside the included script.
Credentials
Only HUBSPOT_TOKEN is required and declared as the primary credential. That token is necessary for all described operations (read/write on CRM objects) and the scope list in the README matches the operations.
Persistence & Privilege
The skill does not request always:true or any system-wide changes. It's user-invocable and does not claim persistent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install native-hubspot - After installation, invoke the skill by name or use
/native-hubspot - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Update display name to Native HubSpot
v0.1.0
Initial release of native-hubspot skill.
- Enables direct querying and management of HubSpot CRM (contacts, companies, deals, tickets, pipelines) via the official API.
- Supports searching, listing, retrieving, creating, updating, and associating CRM objects.
- No third-party proxy; connects directly to api.hubapi.com.
- Requires setup with a HubSpot private app and access token.
- Provides a set of Python CLI command examples for all supported operations.
Metadata
Frequently Asked Questions
What is Native 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 crea... It is an AI Agent Skill for Claude Code / OpenClaw, with 742 downloads so far.
How do I install Native HubSpot?
Run "/install native-hubspot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Native HubSpot free?
Yes, Native HubSpot is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Native HubSpot support?
Native HubSpot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Native HubSpot?
It is built and maintained by codeninja23 (@codeninja23); the current version is v1.0.1.
More Skills