Skip to content

strands-hubspot

Community Contribution

This is a community-maintained package that is not owned or supported by the Strands team. Validate and review the package before using it in your project.

Have your own integration? We'd love to add it here too!

strands-hubspot is a production-ready HubSpot CRM tool designed for READ-ONLY operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information.

This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows.

Installation

pip install strands-hubspot

Usage

from strands import Agent
from strands_hubspot import hubspot

# Create an agent with HubSpot READ-ONLY tool
agent = Agent(tools=[hubspot])

# Search contacts (READ-ONLY)
agent("find all contacts created in the last 30 days")

# Get company details (READ-ONLY)
agent("get company information for ID 67890")

# List available properties (READ-ONLY)
agent("show me all available deal properties")

# Search with filters (READ-ONLY)
agent("search for deals with amount greater than 10000")

Key Features

  • Universal READ-ONLY Access: Safely search ANY HubSpot object type (contacts, deals, companies, tickets, etc.)
  • Smart Search: Advanced filtering with property-based queries and sorting
  • Object Retrieval: Get detailed information for specific CRM objects by ID
  • Property Discovery: List and explore all available properties for any object type
  • User Management: Get HubSpot user/owner details and assignments
  • 100% Safe: NO CREATE, UPDATE, or DELETE operations - read-only by design
  • Rich Console Output: Beautiful table displays with Rich library formatting
  • Type Safe: Full type hints and comprehensive error handling

Configuration

Set your HubSpot API key as an environment variable:

HUBSPOT_API_KEY=your_hubspot_api_key      # Required
HUBSPOT_DEFAULT_LIMIT=100                 # Optional

Get your API key at: HubSpot Private Apps

Resources