← Back to Skills Marketplace
144
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install fr3k-hubspot-crm
Description
Full HubSpot CRM automation — contacts, deals, companies, activities, and pipeline reports via the HubSpot API.
README (SKILL.md)
HubSpot CRM
Automate your entire HubSpot CRM from the command line. Create and manage contacts, deals, and companies; log activities (calls, emails, meetings, notes); and pull pipeline reports with conversion rates — all via the official HubSpot API with a single Bearer token.
Setup
Set your HubSpot Private App token as an environment variable:
export HUBSPOT_API_KEY="pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Get your token: HubSpot → Settings → Integrations → Private Apps → Create a private app.
Required scopes: crm.objects.contacts, crm.objects.deals, crm.objects.companies, crm.schemas.contacts, sales-email-read.
Commands / Usage
# ── CONTACTS ────────────────────────────────────────────
# List contacts (default 20, up to 100)
python3 scripts/hubspot_crm.py contacts-list
python3 scripts/hubspot_crm.py contacts-list --limit 50
# Search contacts by email or name
python3 scripts/hubspot_crm.py contacts-search --query "[email protected]"
python3 scripts/hubspot_crm.py contacts-search --query "John Smith"
# Create a contact
python3 scripts/hubspot_crm.py contacts-create --email "[email protected]" --firstname "Jane" --lastname "Doe" --phone "+1-555-0100" --company "Acme"
# Update a contact
python3 scripts/hubspot_crm.py contacts-update --id 12345 --phone "+1-555-9999" --jobtitle "CTO"
# Delete a contact
python3 scripts/hubspot_crm.py contacts-delete --id 12345
# ── DEALS ───────────────────────────────────────────────
# List all deals
python3 scripts/hubspot_crm.py deals-list
python3 scripts/hubspot_crm.py deals-list --limit 50
# Create a deal
python3 scripts/hubspot_crm.py deals-create --name "Acme Enterprise License" --stage "appointmentscheduled" --amount 12000 --contact-id 12345
# Update a deal
python3 scripts/hubspot_crm.py deals-update --id 67890 --stage "closedwon" --amount 15000
# Move deal stage
python3 scripts/hubspot_crm.py deals-move-stage --id 67890 --stage "contractsent"
# List pipeline stages
python3 scripts/hubspot_crm.py pipeline-list
# ── COMPANIES ───────────────────────────────────────────
# Create a company
python3 scripts/hubspot_crm.py companies-create --name "Acme Corp" --domain "acme.com" --industry "TECHNOLOGY"
# Search companies
python3 scripts/hubspot_crm.py companies-search --query "Acme"
# Associate contact with company
python3 scripts/hubspot_crm.py companies-associate --company-id 11111 --contact-id 22222
# ── ACTIVITIES ──────────────────────────────────────────
# Log an email activity
python3 scripts/hubspot_crm.py log-email --contact-id 12345 --subject "Follow-up" --body "Hi Jane, just checking in..."
# Log a call
python3 scripts/hubspot_crm.py log-call --contact-id 12345 --duration 300 --notes "Discussed pricing, very interested"
# Log a meeting
python3 scripts/hubspot_crm.py log-meeting --contact-id 12345 --title "Demo call" --notes "Showed product, positive feedback"
# Log a note
python3 scripts/hubspot_crm.py log-note --contact-id 12345 --body "Called and left voicemail"
# ── REPORTS ─────────────────────────────────────────────
# Get deal pipeline summary
python3 scripts/hubspot_crm.py report-pipeline
# Get conversion rates per stage
python3 scripts/hubspot_crm.py report-conversions
Requirements
- Python 3.8+
requests(standard:pip install requests)HUBSPOT_API_KEYenvironment variable
Usage Guidance
This skill appears to do what it says: a simple CLI that uses a HubSpot private-app Bearer token to manage CRM data. Before installing or running it, verify these points: (1) the registry metadata omitted the required HUBSPOT_API_KEY — you must set that env var; (2) only provide a HubSpot token with the minimal scopes needed (avoid broad admin tokens); (3) review the included scripts/hubspot_crm.py yourself to confirm there are no modifications you dislike; (4) run it from a safe or disposable environment (or with a test HubSpot account) until you trust it; and (5) because the skill source/homepage is unknown, prefer obtaining code from an official or verified source when possible and rotate/revoke tokens after testing.
Capability Analysis
Type: OpenClaw Skill
Name: fr3k-hubspot-crm
Version: 1.0.0
The HubSpot CRM skill is a legitimate tool for managing contacts, deals, and activities via the official HubSpot API. The Python script `scripts/hubspot_crm.py` implements standard CRM operations using the `requests` library and follows the functionality described in `SKILL.md` without any evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, and the included Python CLI implement HubSpot CRM operations (contacts, deals, companies, activities, reports) against api.hubapi.com. The requested functionality aligns with the stated purpose.
Instruction Scope
SKILL.md instructs only to set a HUBSPOT_API_KEY and run the provided Python script. The script only calls HubSpot API endpoints and prints results; it does not reference other system files, other environment variables, or external endpoints beyond api.hubapi.com.
Install Mechanism
No install spec is provided (instruction-only plus an included Python script). It requires Python and the requests library, which is proportionate for a CLI script. Nothing is downloaded or extracted by the skill itself.
Credentials
The SKILL.md and script require a HUBSPOT_API_KEY (a private-app Bearer token) and list required HubSpot scopes, which is appropriate. However, the registry metadata incorrectly lists 'Required env vars: none' and 'Primary credential: none' — an incoherence that could lead users to miss the need to provide the token. The skill only needs that one token; no unrelated credentials are requested.
Persistence & Privilege
The skill is not marked always:true and does not persist or modify other skills or system-wide settings. It runs as a one-off CLI tool using the environment token.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install fr3k-hubspot-crm - After installation, invoke the skill by name or use
/fr3k-hubspot-crm - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of HubSpot CRM automation skill.
- Manage contacts, deals, companies, and activities from the command line using the HubSpot API.
- Includes support for searching, creating, updating, deleting, and associating records.
- Log activities such as calls, emails, meetings, and notes.
- Generate deal pipeline and conversion reports.
- Setup requires only a HubSpot Private App token (single Bearer token).
Metadata
Frequently Asked Questions
What is Hubspot Crm?
Full HubSpot CRM automation — contacts, deals, companies, activities, and pipeline reports via the HubSpot API. It is an AI Agent Skill for Claude Code / OpenClaw, with 144 downloads so far.
How do I install Hubspot Crm?
Run "/install fr3k-hubspot-crm" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hubspot Crm free?
Yes, Hubspot Crm is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Hubspot Crm support?
Hubspot Crm is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hubspot Crm?
It is built and maintained by fr3kstyle (@fr3kstyle); the current version is v1.0.0.
More Skills