[NEW CONTENT] Add strands-hubspot to Community Packages - READ-ONLY CRM Integration Tool

[eraykeskinmac]

Proposed Content

I would like to propose adding strands-hubspot to the Community Packages documentation.

This is a production-ready, READ-ONLY HubSpot CRM integration tool for Strands Agents. It provides safe, comprehensive access to HubSpot data without modification risk. The tool enables agents to:

• Universal READ-ONLY Access: Safely search ANY HubSpot object type (contacts, deals, companies, tickets, custom objects)
• Smart Search: Advanced filtering with property-based queries and complex conditions
• 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

Package Information:

• PyPI: https://pypi.org/project/strands-hubspot/
• GitHub: https://github.com/eraykeskinmac/strands-hubspot
• Examples: https://github.com/eraykeskinmac/strands-tools-examples

Installation:

pip install strands-hubspot
pip install 'strands-agents[anthropic]'

Quick Usage Example:

from strands import Agent
from strands_hubspot import hubspot

agent = Agent(tools=[hubspot])

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

# Get object details (READ-ONLY)
agent("get contact details for ID 12345")

# Discover properties (READ-ONLY)
agent("list all available deal properties")

# Advanced search (READ-ONLY)
agent("search for companies in technology industry")

Location

**Location:**valuable for the Strands Agents community because:

1. Production Safety: The READ-ONLY design ensures zero risk of data corruption or accidental modifications in HubSpot CRM, making it safe for AI agents to explore and analyze production data.

2. Essential Business Integration: CRM access is critical for modern AI agents in sales, marketing, and customer support workflows. This tool enables agents to access customer data, analyze pipelines, and generate insights.

3. Universal CRM Access: Works with ANY HubSpot object type (contacts, deals, companies, tickets, custom objects), providing complete flexibility for diverse business needs.

4. Complete Workflows: Integrates seamlessly with other community tools (strands-deepgram for call transcription, strands-teams for notifications) to create end-to-end business workflows like: transcribe call → lookup customer in HubSpot → send summary to Teams.

5. Analytics & Insights: Perfect for data quality audits, pipeline analysis, lead research, customer intelligence, and reporting - all without touching production data.

6. Follows Best Practices: Published on PyPI, follows strands-{thing} naming convention, includes comprehensive documentation, thorough error handling, and demonstrates proper tool implementation patterns.

7. Community Benefit: Open-source with real-world examples showing how to build safe, production-ready CRM integrations for AI agents.

Rationale

Rationale: Overview

READ-ONLY HubSpot CRM integration for safe data access

Key Features

• Universal READ-ONLY access to all HubSpot objects
• Advanced search and filtering capabilities
• Property discovery and exploration
• User/owner management
• Rich console output with tables
• 100% safe - no write operations

Why READ-ONLY?

Explanation of safety benefits and use cases

Installation

pip install strands-hubspot

Configuration

Required environment variables (HUBSPOT_API_KEY)

Supported Actions

• search: Find objects with advanced filters
• get: Retrieve specific objects by ID
• list_properties: Discover available properties
• get_property: Get property metadata
• get_user_details: User information

Usage Examples

• Search contacts with filters
• Get deal details
• Discover custom properties
• Analyze pipeline data
• Data quality audits

Use Cases

• Analytics & Reporting
• Customer Research
• Sales Intelligence
• Lead Analysis
• Data Quality Audits

Links

• PyPI package
• GitHub repository
• Example repository

Content Outline (Optional)

strands-hubspot

Overview

READ-ONLY HubSpot CRM integration for safe data access

Key Features

• Universal READ-ONLY access to all HubSpot objects
• Advanced search and filtering capabilities
• Property discovery and exploration
• User/owner management
• Rich console output with tables
• 100% safe - no write operations

Why READ-ONLY?

Explanation of safety benefits and use cases

Installation

pip install strands-hubspot

Configuration

Required environment variables (HUBSPOT_API_KEY)

Supported Actions

• search: Find objects with advanced filters
• get: Retrieve specific objects by ID
• list_properties: Discover available properties
• get_property: Get property metadata
• get_user_details: User information

Usage Examples

• Search contacts with filters
• Get deal details
• Discover custom properties
• Analyze pipeline data
• Data quality audits

Use Cases

• Analytics & Reporting
• Customer Research
• Sales Intelligence
• Lead Analysis
• Data Quality Audits

Links

• PyPI package
• GitHub repository
• Example repository

References

• PyPI Package: https://pypi.org/project/strands-hubspot/
• GitHub Repository: https://github.com/eraykeskinmac/strands-hubspot
• Examples Repository: https://github.com/eraykeskinmac/strands-tools-examples
• HubSpot API Documentation: https://developers.hubspot.com/
• Strands Community Package Guidelines: https://strandsagents.com/latest/documentation/docs/community/community-packages/