HubSpot MCP Server

MCP Server for the HubSpot API, enabling Claude to interact with HubSpot CRM for sales analysis and insights.

Disclaimer

This open-source project is not affiliated with or endorsed by HubSpot. It is an independent implementation that interacts with HubSpot’s API.

Tools

Core CRM Tools

1. hubspot_search_contacts

   • Search for contacts in HubSpot using a query string
   • Required inputs:
     • query (string): Search query string (email, name, etc.)
   • Optional inputs:
     • count (number, default: 10): Maximum number of contacts to return
     • propertyList (array): List of properties to include in results
   • Returns: List of matching contacts with their properties

2. hubspot_get_contact

   • Get a specific contact by ID
   • Required inputs:
     • contactId (string): The ID of the contact to retrieve
   • Optional inputs:
     • properties (array): List of properties to include in results
   • Returns: Contact details with specified properties

3. hubspot_create_contact

   • Create a new contact in HubSpot
   • Required inputs:
     • properties (object): Contact properties with at least email field
   • Returns: Created contact details

4. hubspot_update_contact

   • Update an existing contact in HubSpot
   • Required inputs:
     • contactId (string): The ID of the contact to update
     • properties (object): Contact properties to update
   • Returns: Updated contact confirmation

5. hubspot_list_deals

   • List deals in HubSpot with pagination
   • Optional inputs:
     • limit (number, default: 10, max: 100): Maximum number of deals to return
     • after (string): Pagination cursor for next page
     • properties (array): List of properties to include in results
   • Returns: List of deals with their details

6. hubspot_get_deal

   • Get a specific deal by ID
   • Required inputs:
     • dealId (string): The ID of the deal to retrieve
   • Optional inputs:
     • properties (array): List of properties to include in results
   • Returns: Deal details with specified properties

7. hubspot_create_deal

   • Create a new deal in HubSpot
   • Required inputs:
     • properties (object): Deal properties with at least dealname field
   • Returns: Created deal details

8. hubspot_update_deal

   • Update an existing deal in HubSpot
   • Required inputs:
     • dealId (string): The ID of the deal to update
     • properties (object): Deal properties to update
   • Returns: Updated deal confirmation

9. hubspot_list_companies

   • List companies in HubSpot with pagination
   • Optional inputs:
     • limit (number, default: 10, max: 100): Maximum number of companies to return
     • after (string): Pagination cursor for next page
     • properties (array): List of properties to include in results
   • Returns: List of companies with their details

10. hubspot_get_company

    • Get a specific company by ID
    • Required inputs: