HubSpot Activities & Associations
Overview
Activities in HubSpot encompass tasks, notes, and other engagement records that track interactions with contacts, companies, deals, and tickets. Associations are the links that connect HubSpot CRM objects together -- a contact associated with a company, a deal associated with a contact, a note associated with a ticket. For MSPs, activities provide the service history and follow-up tracking that drives client satisfaction, while associations ensure that every interaction is visible from any related record.
MCP Tools
Available Tools
Activity Tools
| Tool | Description | Key Parameters |
|---|---|---|
hubspot_create_task | Create a task | hs_task_subject (required), hs_task_body, hs_task_priority, hs_timestamp |
hubspot_create_note | Create a note | hs_note_body (required), hs_timestamp |
Association Tools
| Tool | Description | Key Parameters |
|---|---|---|
hubspot_create_association | Create an association between two objects | fromObjectType, fromObjectId, toObjectType, toObjectId, associationType |
hubspot_access_associations | List associations for an object | objectType, objectId, toObjectType |
Utility Tools
| Tool | Description | Key Parameters |
|---|---|---|
hubspot_open_hubspot_ui | Open HubSpot UI for an object | objectType, objectId |
hubspot_get_user_details | Get details of the current user | None |
Create a Task
Call hubspot_create_task to create a follow-up task:
Example: Create a follow-up task:
hs_task_subject:Follow up with Acme Corp on managed services proposalhs_task_body:Review proposal feedback and schedule next call. Contact: John Smith, IT Director.hs_task_priority:HIGHhs_timestamp:2026-03-01T09:00:00.000Zhubspot_owner_id:67890
Example: Create an onboarding task:
hs_task_subject:Complete Acme Corp onboarding checklisths_task_body:Set up monitoring agents, configure backup, verify antivirus deployment.hs_task_priority:HIGHhs_timestamp:2026-02-28T09:00:00.000Z
Create a Note
Call hubspot_create_note to log an activity:
Example: Log a meeting note:
hs_note_body:Met with John Smith (IT Director) at Acme Corp. Discussed current IT pain points: frequent email outages, no backup solution, aging network switches. Interested in managed IT services package. Follow-up scheduled for March 1.hs_timestamp:2026-02-24T15:00:00.000Z
Example: Log a support resolution:
hs_note_body:Resolved email delivery issue for Acme Corp. Root cause: misconfigured SPF record. Updated DNS TXT record and verified delivery to all 5 affected users. Monitoring for 24 hours.hs_timestamp:2026-02-24T11:30:00.000Z
Create an Association
Call hubspot_create_association to link two CRM objects:
Example: Associate a contact with a company:
fromObjectType:contactfromObjectId:12345toObjectType:companytoObjectId:98765associationType:contact_to_company
Example: Associate a deal with a company:
fromObjectType:dealfromObjectId:54321toObjectType:companytoObjectId:98765associationType:deal_to_company
Example: Associate a note with a contact:
fromObjectType:notefromObjectId:88888toObjectType:contacttoObjectId:12345associationType:note_to_contact
Access Associations
Call hubspot_access_associations to list all objects associated with a given object:
Example: Get all contacts for a company:
objectType:companyobjectId:98765toObjectType:contact
Example: Get all deals for a contact:
objectType:contactobjectId:12345toObjectType:deal
Example: Get all tickets for a company:
objectType:companyobjectId:98765toObjectType:ticket
Key Concepts
Association Types
HubSpot supports associations between all major CRM object types:
| From | To | Association Type | Description |
|---|---|---|---|
| contact | company | contact_to_company | Person works at organization |
| deal | contact | deal_to_contact | Contact is involved in the deal |
| deal | company | deal_to_company | Deal is for this company |
| ticket | contact | ticket_to_contact | Contact reported the ticket |
| ticket | company | ticket_to_company | Ticket is for this company |
| note | contact | note_to_contact | Note is about this contact |
| note | company | note_to_company | Note is about this company |
| note | deal | note_to_deal | Note is about this deal |
| note | ticket | note_to_ticket | Note is about this ticket |
| task | contact | task_to_contact | Task is for this contact |
| task | company | task_to_company | Task is for this company |
| task | deal | task_to_deal | Task is related to this deal |
Task Priority Levels
| Priority | Description | MSP Context |
|---|---|---|
NONE | No priority set | General follow-up |
LOW | Low priority | Non-urgent task |
MEDIUM | Medium priority | Standard follow-up |
HIGH | High priority | Time-sensitive action required |
Task Status
Tasks track completion status:
| Status | Description |
|---|---|
NOT_STARTED | Task created, not yet started |
IN_PROGRESS | Currently working on |
WAITING | Waiting for external input |
COMPLETED | Task done |
DEFERRED | Postponed |
Notes vs. Tasks
| Feature | Notes | Tasks |
|---|---|---|
| Purpose | Record what happened | Track what needs to happen |
| Time reference | Past events | Future actions |
| Completion | No status tracking | Has completion status |
| Priority | Not applicable | Has priority level |
| Due date | Not applicable | Has due date/timestamp |
| MSP example | "Resolved printer issue" | "Follow up on network upgrade quote" |
Common Workflows
Log a Client Meeting
- Create the note - Call
hubspot_create_notewith meeting summary - Associate with contact - Call
hubspot_create_associationfrom note to the contact(s) who attended - Associate with company - Call
hubspot_create_associationfrom note to the company - Associate with deal - If the meeting relates to a deal, associate the note with the deal
- Create follow-up tasks - Call
hubspot_create_taskfor any action items from the meeting
Create a Follow-Up Task
- Create the task - Call
hubspot_create_taskwith subject, body, priority, and due date - Assign the task - Set
hubspot_owner_idto the responsible team member - Associate with relevant objects - Link to the contact, company, and/or deal
Associate a New Contact with Existing Records
- Create the contact - Call
hubspot_create_contact - Associate with company - Call
hubspot_create_associationfrom contact to company - Associate with deals - If the contact is involved in active deals, create those associations
- Log the setup - Call
hubspot_create_notedocumenting the new contact and their role
Full Client Relationship View
- Find the company - Call
hubspot_search_companiesby name or domain - Get contacts - Call
hubspot_access_associationswithtoObjectType=contact - Get deals - Call
hubspot_access_associationswithtoObjectType=deal - Get tickets - Call
hubspot_access_associationswithtoObjectType=ticket - Retrieve details - For each associated object, call the appropriate retrieve tool
- Present the complete picture - Company details, all contacts with roles, all deals with stages, all tickets with status
Onboarding Workflow
- Create onboarding tasks - Create tasks for each onboarding step:
- Set up monitoring agents
- Configure