hubspot-connect

Manages HubSpot CRM contacts, companies, deals, and engagements through Python scripts.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-connect-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-connect
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-connect
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-connect-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connecting to HubSpot CRM from an AI assistant normally requires writing API calls, handling authentication tokens, and remembering endpoint details for every operation. This Skill provides a single entry point that validates your HubSpot configuration and routes natural-language requests to the correct CRM operation. ## Core Features & Use Cases - Contact & Company Management: List, create, search, and update contacts and companies via HubSpot Private App tokens. - Deal Pipeline Operations: Create, update, and search deals, plus retrieve associations between linked records. - Engagement Logging: Log and list emails, calls, notes, and meetings directly in the CRM. - Use Case: A sales rep says "create a new deal for Acme Corp worth $50,000" and the Skill validates the token, runs the create_deal script, and returns the new deal ID and stage. ## Quick Start Say "list my HubSpot contacts" and the Skill will verify your configuration and display your contacts.

Frequently Asked Questions about hubspot-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect an AI assistant to HubSpot CRM?

Create a HubSpot Private App under Settings → Integrations → Private Apps, grant CRM scopes for contacts, companies, and deals, then save the access token as HUBSPOT_ACCESS_TOKEN in a .env file. The Skill validates this configuration before running any operation.

How do I create a contact in HubSpot from the command line?

Run the create_contact.py script with an email address and optional fields like firstname, lastname, and phone. The script calls the HubSpot API and returns the new contact record as JSON.

What HubSpot scopes are needed for CRM operations?

You need crm.objects.contacts, companies, and deals read/write scopes for core CRM work. Engagement features additionally require read/write scopes for emails, calls, notes, and meetings objects.

Why am I getting a 403 Forbidden error from the HubSpot API?

A 403 error means your Private App is missing a required scope. Add the missing scope in HubSpot settings, commit the changes, then copy the newly generated access token since tokens change after scope updates.

Can I log sales calls and emails to HubSpot automatically?

Yes, the Skill includes scripts to log emails, calls, notes, and meetings as HubSpot engagements. Provide details like subject, body, and duration, and the record is created via the engagements API.