Manage contacts, companies, deals, tickets, and more in HubSpot CRM with natural-language prompts. Let Gumloop handle the heavy lifting while you stay focused on growing relationships and revenue.
All-in-one access to contacts, companies, deals, tickets, products, engagements, and associations so you can run every stage of the customer journey from a single place.

​
What is HubSpot MCP?

HubSpot MCP creates an AI-powered node that understands the HubSpot API for you. Instead of understanding endpoints or writing code, simply describe what you want and the node handles the rest.

​
What Can It Do for You?

  • Instantly pull, create, or update contacts, companies, and deals with a single prompt
  • Automate ticket creation and support workflows directly from chat or forms
  • Log calls, emails, meetings, and tasks so your CRM always stays up to date
  • Link records together (contact to company, deal to product, etc.) to keep data organized

​
Available Tools

ToolWhat It DoesExample Use
List ContactsList HubSpot contacts with optional filtering”List the first 10 contacts created this month and return id, firstname, lastname, email”
Create ContactCreate a new HubSpot contact”Create a contact named Jane Doe, email jane@acme.com, phone 415-555-1234, and return the new contact id”
Get ContactRetrieve a specific HubSpot contact by ID”Get contact with email john.smith@techcorp.com and return firstname, lastname, email, lifecycle_stage”
Update ContactUpdate an existing HubSpot contact”Update contact sarah@startup.io, set lifecycle_stage to ‘customer’, and return id and lifecycle_stage”
Search ContactsSearch for HubSpot contacts using advanced filters”Find contacts where company = ‘Microsoft’ and job_title contains ‘Director’, return id, firstname, email”
Search CompaniesSearch for HubSpot companies with advanced filters and sorting”Search companies with industry = ‘SaaS’ and annual_revenue > 5000000, sort by annual_revenue desc, return id and name”
List CompaniesList HubSpot companies with optional filtering”List 20 companies created last week and return id, name, domain”
Create CompanyCreate a new HubSpot company”Create a company named Rocket Corp, domain rocket.io, and return company id”
Get CompanyRetrieve a specific HubSpot company by ID”Get company ‘Acme Corporation’ and return name, domain, annual_revenue”
Update CompanyUpdate an existing HubSpot company”Update company ‘TechStartup Inc’, set lifecycle_stage to ‘opportunity’, return id and lifecycle_stage”
List DealsList HubSpot deals with optional filtering”List deals in stage ‘negotiation’ created this quarter, return id, dealname, amount”
Create DealCreate a new HubSpot deal”Create a deal named ‘Enterprise License - DataCorp Q2’, amount 75000, stage ‘proposal’, return deal id”
Update DealUpdate an existing HubSpot deal”Update deal ‘Annual Renewal - Acme’, set stage to ‘closed won’, return id and stage”
Get EngagementsGet engagement data (calls, emails, meetings, etc.) for a contact”Get engagements for contact mike@bigcorp.com and return id, type, subject, timestamp”
Send EmailSend an email to a HubSpot contact”Send an email to contact lisa@prospect.com with subject ‘Product Demo Follow-up’ and body ‘[email_content]’, return engagement id”
List TicketsList HubSpot tickets with optional filtering”List open tickets with priority ‘high’, return id, subject, status”
Get TicketGet a specific HubSpot ticket by ID”Get ticket ‘Login issues - Customer #4521’ and return subject, status, priority”
Create TicketCreate a new HubSpot ticket”Create a ticket subject ‘Billing discrepancy’ for contact support@client.com, return ticket id”
Update TicketUpdate an existing HubSpot ticket”Update ticket ‘Feature request - Dark mode’, set status to ‘in progress’, return id and status”
Delete TicketArchive or delete a HubSpot ticket”Delete ticket ‘Spam - Please ignore’ and confirm deletion”
Merge TicketsMerge two HubSpot tickets into one”Merge duplicate tickets about ‘Password reset’ into the original ticket and return merged ticket id”
List ProductsList HubSpot products with optional filtering”List active products priced over 100, return id, name, price”
Get ProductGet a specific HubSpot product by ID”Get product ‘Premium Subscription Plan’ and return name, price, description”
Create ProductCreate a new HubSpot product”Create a product name ‘Enterprise Add-on’, price 999, return product id”
Update ProductUpdate an existing HubSpot product”Update product ‘Basic Plan’, set price to 49.99, return id and price”
Delete ProductArchive or delete a HubSpot product”Delete product ‘Legacy Feature - Deprecated’ and confirm deletion”
Get EngagementGet a specific HubSpot engagement by ID”Get the most recent call with ‘Acme Corp’ and return type, subject, timestamp”
List EngagementsList HubSpot engagements with optional filtering”List email engagements from last 7 days, return id, subject, contact_id”
Get Recent EngagementsGet recently created or updated engagements”Get recent engagements updated today, return id, type, timestamp”
Get Call DispositionsGet all possible dispositions for sales calls”List call dispositions and return id and label”
Create EngagementCreate a new engagement (email, call, meeting, task, or note)“Create a note on contact ceo@fortune500.com with body ‘Interested in enterprise features, follow up next week’, return engagement id”
Update EngagementUpdate an existing engagement”Update meeting notes for ‘Quarterly Business Review’, set body to ‘Discussed expansion plans’, return id and body”
Delete EngagementDelete a HubSpot engagement”Delete test engagement ‘Demo call - internal testing’ and confirm deletion”
Merge ContactsMerge two HubSpot contacts into one”Merge duplicate contact john@company.com into j.doe@company.com and return merged contact id”
Gdpr Delete ContactPermanently delete a contact and all associated content”GDPR delete contact opt-out@example.com and confirm removal”
Get AssociationsGet all associations for a specific object”Get associations for deal ‘Enterprise Contract 2024’ and return associated_contact_ids”
Create AssociationCreate an association between two objects”Associate deal ‘New Partnership - TechCo’ with contact vp.sales@techco.com and return confirmation”
Delete AssociationRemove an association between two objects”Delete association between deal ‘Lost Opportunity’ and contact former.employee@company.com”
Get Association TypesGet available association types and labels”List association types between contacts and companies”

​
How to Use

1

Create Your HubSpot MCP Node

Go to your node library, search for HubSpot, and click “Create a node with AI”
2

Add Your Prompt

Drag the HubSpot node to your canvas and describe the single action you want to perform.
3

Test Your Node

Run the node to see the results. If it works as expected, you’re all set. If you run into issues, check the troubleshooting tips below.
4

Save and Reuse

Once your HubSpot node is working, save it to your library for future workflows.

​
Example Prompts

With 40 available tools, these examples showcase common use cases. Feel free to experiment with natural-language prompts. Contacts: 
Search contacts where city = "Austin" and lifecycle_stage = "lead", return id, firstname, lastname, email
Companies: 
Create a company named "Nimbus Cloud", domain nimbus.io, phone 312-555-9988, return company id
Deals: 
Update deal 54123, set amount to 125000 and stage to "contractsent", return id, amount, stage
Tickets: 
List open tickets with priority high created this month, return id, subject, status
Engagements: 
Create a call engagement for contact 12345 with duration 15 minutes and outcome "Connected", return engagement id
Associations: 
Associate contact 12345 to company 67890 with label "Decision Maker" and return confirmation
For best results, start with a clear, focused prompt like “List contacts created today” before adding filters or extra fields. Small, single-action prompts run faster and are easier to build on top of.

​
Troubleshooting

If your HubSpot MCP node isn’t working as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “List contacts created yesterday and return id, firstname, email”
  • Less Efficient: “List contacts created yesterday, update their lifecycle stage to customer, then send each one a welcome email”
While the complex prompt might work, it’s more efficient to break it into separate nodes. HubSpot MCP works best with focused, single-action prompts.

​
Match What HubSpot Can Do

  • Good: “Create a ticket subject “Website bug” for contact 12345”
  • Less Efficient: “Create a Slack channel and post all new HubSpot tickets there”
HubSpot MCP excels at CRM actions. For Slack notifications, combine it with an appropriate Slack node in your workflow.

​
Break Complex Tasks Into Steps

For best results and to avoid timeouts or errors, break large tasks into smaller prompts. Instead of: 
Search Fortune 500 companies, find contacts, enrich them, create deals, and send welcome emails
Create a series of standalone nodes:
1

Step 1: Search Companies

Search Fortune 500 companies and return company_ids and company_names
2

Step 2: Find Sales Leaders

Find contacts with title “VP of Sales” for company_ids and return contact_ids
3

Step 3: Enrich Contacts

Enrich contact_ids and return email, phone, linkedin_url
Connect these nodes sequentially in your workflow. The output from each step feeds directly into the next node’s input.

​
Focus on Data Retrieval

HubSpot MCP is great at getting information from HubSpot. For analysis or content creation, connect it to other nodes. Example:
  • Good prompt: “Get deal 34567 and return dealname, amount, close_date”
  • Less Efficient: “Get deal 34567, analyze upsell probability, and draft an email to the customer”
Use Ask AI for analysis or email drafting after retrieving data from HubSpot.

​
Troubleshooting Node Creation

​
Need More Help?