tools-only strands-hubspot
{{ community_contribution_banner }}
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