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.
How to Use MCP Nodes
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
| Tool | What It Does | Example Use |
|---|---|---|
| List Contacts | List HubSpot contacts with optional filtering | ”List the first 10 contacts created this month and return id, firstname, lastname, email” |
| Create Contact | Create 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 Contact | Retrieve a specific HubSpot contact by ID | ”Get contact with email john.smith@techcorp.com and return firstname, lastname, email, lifecycle_stage” |
| Update Contact | Update an existing HubSpot contact | ”Update contact sarah@startup.io, set lifecycle_stage to ‘customer’, and return id and lifecycle_stage” |
| Search Contacts | Search for HubSpot contacts using advanced filters | ”Find contacts where company = ‘Microsoft’ and job_title contains ‘Director’, return id, firstname, email” |
| Search Companies | Search 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 Companies | List HubSpot companies with optional filtering | ”List 20 companies created last week and return id, name, domain” |
| Create Company | Create a new HubSpot company | ”Create a company named Rocket Corp, domain rocket.io, and return company id” |
| Get Company | Retrieve a specific HubSpot company by ID | ”Get company ‘Acme Corporation’ and return name, domain, annual_revenue” |
| Update Company | Update an existing HubSpot company | ”Update company ‘TechStartup Inc’, set lifecycle_stage to ‘opportunity’, return id and lifecycle_stage” |
| List Deals | List HubSpot deals with optional filtering | ”List deals in stage ‘negotiation’ created this quarter, return id, dealname, amount” |
| Create Deal | Create a new HubSpot deal | ”Create a deal named ‘Enterprise License - DataCorp Q2’, amount 75000, stage ‘proposal’, return deal id” |
| Update Deal | Update an existing HubSpot deal | ”Update deal ‘Annual Renewal - Acme’, set stage to ‘closed won’, return id and stage” |
| Get Engagements | Get engagement data (calls, emails, meetings, etc.) for a contact | ”Get engagements for contact mike@bigcorp.com and return id, type, subject, timestamp” |
| Send Email | Send 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 Tickets | List HubSpot tickets with optional filtering | ”List open tickets with priority ‘high’, return id, subject, status” |
| Get Ticket | Get a specific HubSpot ticket by ID | ”Get ticket ‘Login issues - Customer #4521’ and return subject, status, priority” |
| Create Ticket | Create a new HubSpot ticket | ”Create a ticket subject ‘Billing discrepancy’ for contact support@client.com, return ticket id” |
| Update Ticket | Update an existing HubSpot ticket | ”Update ticket ‘Feature request - Dark mode’, set status to ‘in progress’, return id and status” |
| Delete Ticket | Archive or delete a HubSpot ticket | ”Delete ticket ‘Spam - Please ignore’ and confirm deletion” |
| Merge Tickets | Merge two HubSpot tickets into one | ”Merge duplicate tickets about ‘Password reset’ into the original ticket and return merged ticket id” |
| List Products | List HubSpot products with optional filtering | ”List active products priced over 100, return id, name, price” |
| Get Product | Get a specific HubSpot product by ID | ”Get product ‘Premium Subscription Plan’ and return name, price, description” |
| Create Product | Create a new HubSpot product | ”Create a product name ‘Enterprise Add-on’, price 999, return product id” |
| Update Product | Update an existing HubSpot product | ”Update product ‘Basic Plan’, set price to 49.99, return id and price” |
| Delete Product | Archive or delete a HubSpot product | ”Delete product ‘Legacy Feature - Deprecated’ and confirm deletion” |
| Get Engagement | Get a specific HubSpot engagement by ID | ”Get the most recent call with ‘Acme Corp’ and return type, subject, timestamp” |
| List Engagements | List HubSpot engagements with optional filtering | ”List email engagements from last 7 days, return id, subject, contact_id” |
| Get Recent Engagements | Get recently created or updated engagements | ”Get recent engagements updated today, return id, type, timestamp” |
| Get Call Dispositions | Get all possible dispositions for sales calls | ”List call dispositions and return id and label” |
| Create Engagement | Create 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 Engagement | Update an existing engagement | ”Update meeting notes for ‘Quarterly Business Review’, set body to ‘Discussed expansion plans’, return id and body” |
| Delete Engagement | Delete a HubSpot engagement | ”Delete test engagement ‘Demo call - internal testing’ and confirm deletion” |
| Merge Contacts | Merge two HubSpot contacts into one | ”Merge duplicate contact john@company.com into j.doe@company.com and return merged contact id” |
| Gdpr Delete Contact | Permanently delete a contact and all associated content | ”GDPR delete contact opt-out@example.com and confirm removal” |
| Get Associations | Get all associations for a specific object | ”Get associations for deal ‘Enterprise Contract 2024’ and return associated_contact_ids” |
| Create Association | Create an association between two objects | ”Associate deal ‘New Partnership - TechCo’ with contact vp.sales@techco.com and return confirmation” |
| Delete Association | Remove an association between two objects | ”Delete association between deal ‘Lost Opportunity’ and contact former.employee@company.com” |
| Get Association Types | Get 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: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: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
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the HubSpot MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com