Skip to Content

HubSpot

HubSpot icon
Arcade Optimized

Arcade tools designed for LLMs to interact with Hubspot

Author:Arcade
Version:3.1.2
Auth:User authorization via the Hubspot auth provider
40tools
PyPI VersionPython VersionsWheel StatusDownloadsLicense

Arcade Toolkit for HubSpot enables seamless integration and interaction with HubSpot's CRM functionalities, allowing developers to leverage various activities and data management tools for enhanced customer relationship management.

Capabilities

  • Create, update, and manage companies, contacts, and deals within HubSpot.
  • Log and associate various engagement activities such as calls, emails, meetings, and more.
  • Retrieve detailed information about users, deals, and associated data effectively.
  • Access industry types and manage user assignments efficiently.

OAuth

  • Provider: Unknown
  • Scopes: crm.objects.companies.read, crm.objects.contacts.write, crm.objects.deals.read, oauth, sales-email-read

Secrets

  • No existing secrets.

Available tools(40)

40 of 40 tools
Operations
Behavior
Tool nameDescriptionSecrets
Associate a single activity object to a deal using HubSpot standard association type.
Associate a contact with an existing deal in HubSpot.
Create a call engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.
Create a communication activity for logging communications that are not done via email, call, or meeting. This includes SMS, WhatsApp, LinkedIn messages, physical mail, and custom channel conversations. Must be associated with at least one of: contact, company, or deal. The communication will be assigned to the current user.
Create a new company in HubSpot. Before calling this tool, use Hubspot.GetAvailableIndustryTypes to see valid values.
Create a contact associated with a company.
Create a new deal in HubSpot. If pipeline_id is not provided, the default pipeline will be used. For custom pipelines, deal_stage must be a valid stage ID within the selected pipeline. If deal_stage is not specified, the first stage in the pipeline will be used automatically. It is recommended have already pipeline data available when planning to call this tool.
Create a logged email engagement activity with essential fields including email headers. Must be associated with at least one of: contact, company, or deal. The email will be assigned to the current user.
Create a meeting with essential fields including separate date and time. The start_date and start_time are combined to create the meeting timestamp. Duration can be specified in HH:MM format. Must be associated with at least one of: contact, company, or deal. The meeting will be assigned to the current user.
Create a note engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.
Get all users/owners in the HubSpot portal. This tool retrieves a list of all users (owners) in your HubSpot portal, Useful for user management and assignment operations. Use this tool when needing information about ALL users in the HubSpot portal.
Get all available industry types for HubSpot companies. Returns a sorted list of valid industry type values that can be used when creating companies.
Search for call activities with associated contacts, companies, and deals.
Search for communication activities with associated contacts, companies, and deals.
Retrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.
Retrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.
Retrieve a specific deal by its ID with associated contacts, companies, calls, emails, meetings, notes, and tasks.
Retrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.
List HubSpot deal pipelines with their stages, optionally filtered by a search string. Recommended to be used before creating a new deal. For example updating the stage of a deal without changing the pipeline.
List stages for a specific HubSpot deal pipeline. Useful to get the stage IDs for a specific pipeline.
Search for email activities with associated contacts, companies, and deals.
Search for meeting activities with associated contacts, companies, and deals.
Search for note activities with associated contacts, companies, and deals.
Search for task activities with associated contacts, companies, and deals.
Get detailed information about a specific user/owner by their ID. This tool retrieves comprehensive information about a specific user in your HubSpot portal using their owner ID.
Page 1 of 2(25 of 40)

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

Hubspot.AssociateActivityToDeal

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Associate a single activity object to a deal using HubSpot standard association type.

Parameters

ParameterTypeReq.Description
activity_typestringRequiredEngagement activity type.
notecallemailmeetingtaskcommunication
activity_idintegerRequiredThe activity object ID
deal_idintegerRequiredThe deal ID to associate to

Requirements

No secrets required

Output

Type:jsonAssociate an activity to a deal
#

Hubspot.AssociateContactToDeal

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Associate a contact with an existing deal in HubSpot.

Parameters

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to associate the contact with
contact_idintegerRequiredThe ID of the contact to associate with the deal

Requirements

No secrets required

Output

Type:jsonDictionary containing the association result
#

Hubspot.CreateCallActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a call engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.

Parameters

ParameterTypeReq.Description
titlestringRequiredShort title for the call.
when_occurredstringRequiredWhen the call occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
directionstringOptionalCall direction (INBOUND or OUTBOUND).
INBOUNDOUTBOUND
summarystringOptionalShort summary/notes of the call.
durationintegerOptionalCall duration in seconds.
to_numberstringOptionalPhone number called to.
from_numberstringOptionalPhone number called from.
associate_to_contact_idintegerOptionalContact ID to associate this call with.
associate_to_company_idintegerOptionalCompany ID to associate this call with.
associate_to_deal_idintegerOptionalDeal ID to associate this call with.

Requirements

No secrets required

Output

Type:jsonDetails of the call engagement activity created.
#

Hubspot.CreateCommunicationActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a communication activity for logging communications that are not done via email, call, or meeting. This includes SMS, WhatsApp, LinkedIn messages, physical mail, and custom channel conversations. Must be associated with at least one of: contact, company, or deal. The communication will be assigned to the current user.

Parameters

ParameterTypeReq.Description
channelstringRequiredCommunication channel type.
SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION
when_occurredstringRequiredWhen the communication occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
body_textstringOptionalFull message content.
associate_to_contact_idintegerOptionalContact ID to associate this communication with.
associate_to_company_idintegerOptionalCompany ID to associate this communication with.
associate_to_deal_idintegerOptionalDeal ID to associate this communication with.

Requirements

No secrets required

Output

Type:jsonDetails of the communication engagement activity created.
#

Hubspot.CreateCompany

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a new company in HubSpot. Before calling this tool, use Hubspot.GetAvailableIndustryTypes to see valid values.

Parameters

ParameterTypeReq.Description
company_namestringRequiredThe company name (required)
web_domainstringOptionalThe company web domain (e.g., example.com)
industry_typestringOptionalThe company industry type (case-insensitive).
company_citystringOptionalThe company city location
company_statestringOptionalThe company state or province
company_countrystringOptionalThe company country
phone_numberstringOptionalThe company main phone number
website_urlstringOptionalThe company website URL

Requirements

No secrets required

Output

Type:jsonDictionary containing the created company information
#

Hubspot.CreateContact

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a contact associated with a company.

Parameters

ParameterTypeReq.Description
company_idintegerRequiredThe ID of the company to create the contact for.
first_namestringRequiredThe first name of the contact.
last_namestringOptionalThe last name of the contact.
emailstringOptionalThe email address of the contact.
phonestringOptionalThe phone number of the contact.
mobile_phonestringOptionalThe mobile phone number of the contact.
job_titlestringOptionalThe job title of the contact.

Requirements

No secrets required

Output

Type:jsonCreate a contact associated with a company.
#

Hubspot.CreateDeal

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a new deal in HubSpot. If pipeline_id is not provided, the default pipeline will be used. For custom pipelines, deal_stage must be a valid stage ID within the selected pipeline. If deal_stage is not specified, the first stage in the pipeline will be used automatically. It is recommended have already pipeline data available when planning to call this tool.

Parameters

ParameterTypeReq.Description
deal_namestringRequiredThe deal name (required)
deal_amountnumberOptionalThe deal amount/value
deal_stagestringOptionalThe deal stage
deal_typestringOptionalThe deal type.
newbusinessexistingbusiness
expected_close_datestringOptionalExpected close date in YYYY-MM-DD format
pipeline_idstringOptionalPipeline id. Use 'default' for default pipeline or pass a pipeline id (integer)
deal_ownerstringOptionalThe deal owner user ID
priority_levelstringOptionalPriority level.
lowmediumhigh
deal_descriptionstringOptionalThe deal description

Requirements

No secrets required

Output

Type:jsonDictionary containing the created deal information
#

Hubspot.CreateEmailActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a logged email engagement activity with essential fields including email headers. Must be associated with at least one of: contact, company, or deal. The email will be assigned to the current user.

Parameters

ParameterTypeReq.Description
subjectstringRequiredEmail subject.
when_occurredstringRequiredWhen the email occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
from_emailstringRequiredSender email address.
to_emailstringRequiredPrimary recipient email address.
body_textstringOptionalEmail body in plain text.
body_htmlstringOptionalEmail body in HTML format.
from_first_namestringOptionalSender first name.
from_last_namestringOptionalSender last name.
to_first_namestringOptionalPrimary recipient first name.
to_last_namestringOptionalPrimary recipient last name.
cc_emailsarray<string>OptionalCC recipient email addresses.
bcc_emailsarray<string>OptionalBCC recipient email addresses.
directionstringOptionalDirection the email was sent (EMAIL, INCOMING_EMAIL, FORWARDED_EMAIL).
EMAILINCOMING_EMAILFORWARDED_EMAIL
statusstringOptionalEmail status indicating the state of the email.
BOUNCEDFAILEDSCHEDULEDSENDINGSENT
associate_to_contact_idintegerOptionalContact ID to associate this email with.
associate_to_company_idintegerOptionalCompany ID to associate this email with.
associate_to_deal_idintegerOptionalDeal ID to associate this email with.

Requirements

No secrets required

Output

Type:jsonDetails of the email engagement activity created.
#

Hubspot.CreateMeetingActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a meeting with essential fields including separate date and time. The start_date and start_time are combined to create the meeting timestamp. Duration can be specified in HH:MM format. Must be associated with at least one of: contact, company, or deal. The meeting will be assigned to the current user.

Parameters

ParameterTypeReq.Description
titlestringRequiredMeeting title.
start_datestringRequiredStart date (YYYY-MM-DD format).
start_timestringRequiredStart time (HH:MM or HH:MM:SS format).
durationstringOptionalMeeting duration in HH:MM format (e.g., 1:30 for 1 hour 30 minutes).
locationstringOptionalMeeting location.
outcomestringOptionalMeeting outcome.
SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED
associate_to_contact_idintegerOptionalContact ID to associate this meeting with.
associate_to_company_idintegerOptionalCompany ID to associate this meeting with.
associate_to_deal_idintegerOptionalDeal ID to associate this meeting with.

Requirements

No secrets required

Output

Type:jsonDetails of the meeting engagement activity created.
#

Hubspot.CreateNoteActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create a note engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.

Parameters

ParameterTypeReq.Description
bodystringRequiredThe note content/body.
when_occurredstringRequiredWhen the note was created (ISO date format: YYYY-MM-DDTHH:MM:SS).
associate_to_contact_idintegerOptionalContact ID to associate this note with.
associate_to_company_idintegerOptionalCompany ID to associate this note with.
associate_to_deal_idintegerOptionalDeal ID to associate this note with.

Requirements

No secrets required

Output

Type:jsonDetails of the note engagement activity created.
#

Hubspot.GetAllUsers

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get all users/owners in the HubSpot portal. This tool retrieves a list of all users (owners) in your HubSpot portal, Useful for user management and assignment operations. Use this tool when needing information about ALL users in the HubSpot portal.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonGet all users/owners in the HubSpot portal with their names, emails, IDs, and status.
#

Hubspot.GetAvailableIndustryTypes

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get all available industry types for HubSpot companies. Returns a sorted list of valid industry type values that can be used when creating companies.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:arrayList of all available industry types for HubSpot companies.
#

Hubspot.GetCallDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for call activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in CALL properties.
limitintegerOptionalThe maximum number of calls to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve call activity data with associated contacts, companies, and deals.
#

Hubspot.GetCommunicationDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for communication activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in COMMUNICATION properties.
limitintegerOptionalThe maximum number of communications to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve communication activity data with associated contacts, companies, and deals.
#

Hubspot.GetCompanyDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Retrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for companies. It will match against the company name, phone, and website.
limitintegerOptionalThe maximum number of companies to return. Defaults to 10. Max is 10.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.
#

Hubspot.GetContactDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Retrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for contacts. It will match against the contact's first and last name, email addresses, phone numbers, and company name.
limitintegerOptionalThe maximum number of contacts to return. Defaults to 10. Max is 100.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.
#

Hubspot.GetDealById

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Retrieve a specific deal by its ID with associated contacts, companies, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to retrieve
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.

Requirements

No secrets required

Output

Type:jsonDeal information with associated entities
#

Hubspot.GetDealDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Retrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for deals. It will match against the deal name and description.
limitintegerOptionalThe maximum number of deals to return. Defaults to 10. Max is 10.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.
#

Hubspot.GetDealPipelines

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List HubSpot deal pipelines with their stages, optionally filtered by a search string. Recommended to be used before creating a new deal. For example updating the stage of a deal without changing the pipeline.

Parameters

ParameterTypeReq.Description
searchstringOptionalOptional case-insensitive search string to filter pipelines by id or label

Requirements

No secrets required

Output

Type:jsonList up to 30 deal pipelines with their stages
#

Hubspot.GetDealPipelineStages

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List stages for a specific HubSpot deal pipeline. Useful to get the stage IDs for a specific pipeline.

Parameters

ParameterTypeReq.Description
pipeline_idstringRequiredThe pipeline id (e.g., 'default' or a pipeline GUID)

Requirements

No secrets required

Output

Type:jsonList stages for a specific deal pipeline
#

Hubspot.GetEmailDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for email activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in EMAIL properties.
limitintegerOptionalThe maximum number of emails to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve email activity data with associated contacts, companies, and deals.
#

Hubspot.GetMeetingDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for meeting activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in MEETING properties.
limitintegerOptionalThe maximum number of meetings to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve meeting activity data with associated contacts, companies, and deals.
#

Hubspot.GetNoteDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for note activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in NOTE properties.
limitintegerOptionalThe maximum number of notes to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve note activity data with associated contacts, companies, and deals.
#

Hubspot.GetTaskDataByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for task activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in TASK properties.
limitintegerOptionalThe maximum number of tasks to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonRetrieve task activity data with associated contacts, companies, and deals.
#

Hubspot.GetUserById

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get detailed information about a specific user/owner by their ID. This tool retrieves comprehensive information about a specific user in your HubSpot portal using their owner ID.

Parameters

ParameterTypeReq.Description
owner_idintegerRequiredThe HubSpot owner/user ID to retrieve

Requirements

No secrets required

Output

Type:jsonGet detailed information about a specific user/owner by their ID.
#

Hubspot.ListCompanies

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List companies with associated contacts, deals, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of companies to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonList companies with associated contacts, deals, calls, emails, meetings, notes, and tasks.
#

Hubspot.ListContacts

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List contacts with associated companies, deals, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of contacts to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
company_idintegerOptionalFilter contacts by company ID. Defaults to None (no filtering).
deal_idintegerOptionalFilter contacts by deal ID. Defaults to None (no filtering).
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonList contacts with associated companies, deals, calls, emails, meetings, notes, and tasks.
#

Hubspot.ListDeals

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List deals with associated contacts, companies, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of deals to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
contact_idintegerOptionalFilter deals by contact ID. Defaults to None (no filtering).
company_idintegerOptionalFilter deals by company ID. Defaults to None (no filtering).
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:jsonList deals with associated contacts, companies, calls, emails, meetings, notes, and tasks.
#

Hubspot.ToolkitEnviromentGuidance

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
No

Can call out to external systems.

Get guidance and considerations for using the HubSpot toolkit effectively. This tool provides important context and best practices for working with HubSpot tools. Based on all available HubSpot toolkit tools, some suggestions may apply to tools that are not available in the current agent's configuration.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonList of guidance.
#

Hubspot.UpdateCallActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a call activity directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
call_idintegerOptionalThe call activity ID to update.
keywordsstringOptionalKeywords to search for call summaries or titles. Provide when call_id is not known.
titlestringOptionalUpdated call title.
directionstringOptionalUpdated call direction.
INBOUNDOUTBOUND
summarystringOptionalUpdated call summary.
durationintegerOptionalUpdated call duration in seconds.
to_numberstringOptionalUpdated number called to.
from_numberstringOptionalUpdated number called from.
when_occurredstringOptionalUpdated call timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of calls to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a call by ID or list matching calls when searching by keywords.
#

Hubspot.UpdateCommunicationActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a communication activity by ID or return matches for keyword searches.

Parameters

ParameterTypeReq.Description
communication_idintegerOptionalThe communication activity ID to update.
keywordsstringOptionalKeywords to search for communication body text. Provide when communication_id is not known.
channelstringOptionalUpdated communication channel.
SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION
body_textstringOptionalUpdated message body.
when_occurredstringOptionalUpdated timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of communications to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a communication activity by ID or list matching communications when searching by keywords.
#

Hubspot.UpdateCompany

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a company directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
company_idintegerOptionalThe ID of the company to update.
keywordsstringOptionalKeywords to search for the company (name, domain, website). Provide when company_id is not known.
company_namestringOptionalThe company name.
web_domainstringOptionalThe company web domain (e.g., example.com).
industry_typestringOptionalThe company industry type (case-insensitive).
company_citystringOptionalThe company city location.
company_statestringOptionalThe company state or province.
company_countrystringOptionalThe company country.
phone_numberstringOptionalThe company main phone number.
website_urlstringOptionalThe company website URL.
matches_limitintegerOptionalThe maximum number of companies to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a company by ID or list matching companies when searching by keywords.
#

Hubspot.UpdateContact

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a contact directly by ID or list possible matches when searching by keywords.

Parameters

ParameterTypeReq.Description
contact_idintegerOptionalThe ID of the contact to update.
keywordsstringOptionalKeywords to search for the contact (name, email, phone). Provide when contact_id is not known.
first_namestringOptionalThe first name of the contact.
last_namestringOptionalThe last name of the contact.
emailstringOptionalThe email address of the contact.
phonestringOptionalThe phone number of the contact.
mobile_phonestringOptionalThe mobile phone number of the contact.
job_titlestringOptionalThe job title of the contact.
matches_limitintegerOptionalThe maximum number of contacts to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a contact by ID or list matching contacts when searching by keywords.
#

Hubspot.UpdateDeal

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a deal directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
deal_idintegerOptionalThe ID of the deal to update.
keywordsstringOptionalKeywords to search for the deal (name, description). Provide when deal_id is not known.
deal_namestringOptionalThe deal name.
deal_amountnumberOptionalThe deal amount/value.
deal_stagestringOptionalThe deal stage ID.
deal_typestringOptionalThe deal type. Accepts enum values as strings (e.g., 'newbusiness', 'existingbusiness').
expected_close_datestringOptionalExpected close date in YYYY-MM-DD format.
deal_ownerstringOptionalThe deal owner user ID.
priority_levelstringOptionalPriority level. Accepts enum values as strings (e.g., 'low', 'medium', 'high').
deal_descriptionstringOptionalThe deal description.
matches_limitintegerOptionalThe maximum number of deals to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a deal by ID or list matching deals when searching by keywords.
#

Hubspot.UpdateDealCloseDate

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update the expected close date of an existing deal with associated contacts, companies, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to update
expected_close_datestringRequiredNew expected close date in YYYY-MM-DD format
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.

Requirements

No secrets required

Output

Type:jsonUpdated deal information with associated entities
#

Hubspot.UpdateDealStage

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Updates a deal's stage with associated contacts, companies, calls, emails, meetings, notes, and tasks. Send current_pipeline_id to skip fetching the deal. If pipeline changes are allowed, updates the stage and HubSpot may move the deal to another pipeline. It is recommended have already pipeline data available when planning to call this tool.

Parameters

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to update
deal_stagestringRequiredNew deal stage ID
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
current_pipeline_idstringOptionalCurrent pipeline id for this deal, if already known (skips fetching the deal)
allow_pipeline_changebooleanOptionalIf true, allows changing the deal's pipeline when the stage belongs to another pipeline

Requirements

No secrets required

Output

Type:jsonUpdated deal information with associated entities
#

Hubspot.UpdateEmailActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update an email activity directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
email_idintegerOptionalThe email activity ID to update.
keywordsstringOptionalKeywords to search for email subjects or body text. Provide when email_id is not known.
subjectstringOptionalUpdated email subject.
directionstringOptionalUpdated email direction.
EMAILINCOMING_EMAILFORWARDED_EMAIL
statusstringOptionalUpdated email status.
BOUNCEDFAILEDSCHEDULEDSENDINGSENT
body_textstringOptionalUpdated plain-text body.
body_htmlstringOptionalUpdated HTML body.
when_occurredstringOptionalUpdated email timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of emails to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate an email activity by ID or list matching emails when searching by keywords.
#

Hubspot.UpdateMeetingActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a meeting activity directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
meeting_idintegerOptionalThe meeting activity ID to update.
keywordsstringOptionalKeywords to search for meeting titles. Provide when meeting_id is not known.
titlestringOptionalUpdated meeting title.
start_datestringOptionalUpdated start date (YYYY-MM-DD).
start_timestringOptionalUpdated start time (HH:MM or HH:MM:SS).
durationstringOptionalUpdated duration in HH:MM format.
locationstringOptionalUpdated meeting location.
outcomestringOptionalUpdated meeting outcome.
SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED
matches_limitintegerOptionalMaximum number of meetings to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a meeting activity by ID or list matching meetings when searching by keywords.
#

Hubspot.UpdateNoteActivity

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
CRM
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update a note directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
note_idintegerOptionalThe note ID to update.
keywordsstringOptionalKeywords to search for the note content. Provide when note_id is not known.
bodystringOptionalUpdated note content.
when_occurredstringOptionalUpdated creation timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of notes to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type:jsonUpdate a note by ID or list matching notes when searching by keywords.
#

Hubspot.WhoAmI

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
CRM
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get current user information from HubSpot. This is typically the first tool called to understand the current user context. Use this tool when needing information about the current user basic HubSpot information. and the associated HubSpot portal.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonGet current user information.
Last updated on