Skip to main content
HubSpot is an all-in-one CRM platform for sales, marketing, and customer service. The HubSpot MCP server lets you manage contacts, companies, deals, tickets, and engagements using natural language.

​
What Can It Do?

  • Manage contacts and companies with full CRUD operations
  • Track deals through your sales pipeline
  • Handle support tickets and customer interactions
  • Log engagements like calls, emails, and meetings
  • Create associations between records

​
Where to Use It

Add HubSpot as a tool to any agent. The agent can then manage your CRM conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with HubSpot tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Create a contact with email and name”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
List ContactsList contacts with optional filtering
Create ContactCreate a new contact
Get ContactRetrieve a specific contact by ID
Update ContactUpdate an existing contact
Search ContactsSearch with advanced filters
List CompaniesList companies with filtering
Create CompanyCreate a new company
Get CompanyRetrieve a specific company
Update CompanyUpdate an existing company
Search CompaniesSearch with advanced filters
List DealsList deals with filtering
Create DealCreate a new deal
Update DealUpdate an existing deal
List TicketsList tickets with filtering
Create TicketCreate a new ticket
Update TicketUpdate an existing ticket
Get EngagementsGet engagement data for a contact
Create EngagementCreate a call, email, meeting, or note
Get AssociationsGet associations for an object
Create AssociationLink two objects together

​
Example Prompts

Use these with your agent or in the Agent Node: Find contacts: 
Find all contacts at Microsoft with Director in their title
Create a deal: 
Create a deal called "Enterprise License - Acme" for $75,000 in the proposal stage
Update a contact: 
Update [email protected] to lifecycle stage "customer"
Check tickets: 
Show me all high-priority open tickets
Log an activity: 
Log a 15-minute call with the Acme contact about their renewal

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific names, emails, or IDs
Action not completingCheck that you’ve authenticated with HubSpot
Unexpected resultsThe agent may chain multiple tools (e.g., searching first, then updating). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Update the Acme deal to closed-won” will find the deal first, then update it. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the HubSpot MCP server using your Gumloop credentials.