strands-hubspot

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