Hubspot Automation

Automate HubSpot CRM operations (contacts, companies, deals, tickets, properties) via Rube MCP using Composio integration

Category: productivity Source: davepoon/buildwithclaude

What Is HubSpot Automation?

The HubSpot Automation skill enables seamless automation of HubSpot CRM operations by leveraging Rube MCP (Multi-Cloud Platform) in conjunction with Composio’s integration toolkit. This skill allows users to programmatically manage contacts, companies, deals, tickets, and properties within their HubSpot environment. By integrating Rube MCP and Composio, users can orchestrate sophisticated CRM workflows without manual intervention, making it significantly easier to synchronize, update, and analyze CRM data at scale.

HubSpot Automation is designed for use within Claude Code and related environments, offering a robust bridge between business logic and CRM execution. This skill is particularly well-suited for teams seeking to optimize productivity, reduce repetitive tasks, and enhance data consistency in their CRM processes.

Why Use HubSpot Automation?

Modern sales, marketing, and support teams face increasing pressure to maintain accurate, real-time CRM data while responding quickly to customer needs. Manual data entry and workflow management not only consume valuable time but also introduce opportunities for error and data fragmentation.

Adopting HubSpot Automation provides several compelling benefits:

• Time Efficiency: Automate routine tasks such as contact creation, property updates, and pipeline management, freeing up human resources for more strategic work.
• Consistency and Accuracy: Automated workflows reduce human error, ensuring that your CRM data stays clean and up to date.
• Scalability: As your organization grows, automation enables you to manage larger data volumes and more complex workflows without increasing operational overhead.
• Integration: By connecting with Rube MCP and Composio, you can orchestrate cross-platform workflows, integrating HubSpot with other cloud services and business systems.

How to Get Started

Getting started with HubSpot Automation requires a one-time setup to ensure secure connectivity and access to the necessary tools. Follow these steps:

Prerequisites

• Ensure Rube MCP is available and integrated into your environment.
• Confirm that the Rube MCP endpoint (https://rube.app/mcp) is added as an MCP server in your client configuration. No API keys are required.
• Establish an active HubSpot connection using the Composio toolkit via Rube MCP.

Step-by-Step Setup

1. Verify Rube MCP Availability

   # Example pseudocode
   response = call('RUBE_SEARCH_TOOLS')
   assert response.status == 'success'
   

2. Connect to HubSpot via Composio

   connection = call('RUBE_MANAGE_CONNECTIONS', toolkit='hubspot')
   if connection.status != 'ACTIVE':
       print(f"Visit {connection.auth_link} to complete HubSpot OAuth")
   

3. Authenticate and Confirm Connection

   • Follow the provided authentication link if the connection is not active.
   • Re-run the connection check until status == 'ACTIVE'.

4. Discover Tool Schemas

   schemas = call('RUBE_SEARCH_TOOLS')
   assert 'hubspot' in schemas
   

Note: Always call RUBE_SEARCH_TOOLS first to retrieve the latest schemas and ensure compatibility with available tools.

Key Features

1. Create and Manage Contacts

Automate the creation and updating of contacts in HubSpot.

## Check permissions
call('HUBSPOT_GET_ACCOUNT_INFO')

## Search for existing contacts
contacts = call('HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA', criteria={'email': 'alice@example.com'})

if not contacts:
    # Create new contact
    call('HUBSPOT_CREATE_CONTACT', data={'email': 'alice@example.com', 'firstname': 'Alice'})
else:
    # Update contact
    contact_id = contacts[0]['id']
    call('HUBSPOT_UPDATE_CONTACT', id=contact_id, data={'phone': '+1234567890'})

2. Company Management

Automate workflows for company record creation, updating, and association with contacts.

## Create a new company
call('HUBSPOT_CREATE_COMPANY', data={'name': 'Acme Corp'})

## Associate contact with company
call('HUBSPOT_ASSOCIATE_CONTACT_TO_COMPANY', contact_id=contact_id, company_id=company_id)

3. Deal and Ticket Automation

Track pipeline deals and support tickets programmatically.

## Create a deal
call('HUBSPOT_CREATE_DEAL', data={'dealname': 'New Opportunity', 'amount': 5000})

## Search for tickets
tickets = call('HUBSPOT_SEARCH_TICKETS', criteria={'status': 'open'})

4. Custom Property Management

Create and update custom properties for contacts, companies, or deals.

call('HUBSPOT_CREATE_PROPERTY', object_type='contact', data={'name': 'VIP_Status', 'type': 'bool'})

Best Practices

• Always Authenticate First: Before running any workflow, ensure your HubSpot connection is active using RUBE_MANAGE_CONNECTIONS.
• Schema Discovery: Regularly call RUBE_SEARCH_TOOLS to fetch the latest schemas, as tool capabilities may change over time.
• Error Handling: Implement robust error checking after each API call to handle missing data, permission issues, or schema updates.
• Data Minimization: Only transmit the minimal required data for each operation to optimize performance and security.
• Audit and Logging: Maintain logs of automated actions for compliance and troubleshooting.

Important Notes

• OAuth Authentication: HubSpot connections require OAuth authentication. Always complete the auth flow if prompted by RUBE_MANAGE_CONNECTIONS.
• Tool Availability: The set of available operations may change; always check tool schemas before building or modifying workflows.
• Permissions: Ensure that the OAuth-connected HubSpot user has the necessary permissions for the operations you intend to automate.
• No API Keys Required: All operations are managed via Rube MCP and Composio, so you do not need to handle API keys directly.
• Documentation: Refer to the Composio HubSpot Toolkit documentation for detailed API references and supported operations.

By following these guidelines and leveraging the HubSpot Automation skill, organizations can achieve reliable and scalable CRM automation tailored to their unique business processes.