Sign in Book a demo
Back to Tools
Sales & CRM OAuth
Build Your Agent View HubSpot Docs
hubspot logo

HubSpot MCP Tools for AI Agents

Let an agent find contacts, companies, and deals, log activities, create records, and update deal stages in HubSpot.

Available Tools

58 tools available in this integration

Hubspot.AssociateActivityToDeal

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

Hubspot.AssociateContactToDeal

Associate a contact with an existing deal in HubSpot.

Hubspot.CreateCallActivity

Create a call engagement activity with required owner and associations.

Hubspot.CreateCommunicationActivity

Create a communication activity for logging communications that are not done via

Hubspot.CreateCompany

Create a new company in HubSpot.

Hubspot.CreateContact

Create a contact associated with a company.

Hubspot.CreateDeal

Create a new deal in HubSpot.

Hubspot.CreateEmailActivity

Create a logged email engagement activity with essential fields including email headers.

Hubspot.CreateMeetingActivity

Create a meeting with essential fields including separate date and time.

Hubspot.CreateNoteActivity

Create a note engagement activity with required owner and associations.

Hubspot.GetAllUsers

Get all users/owners in the HubSpot portal.

Hubspot.GetAvailableIndustryTypes

Get all available industry types for HubSpot companies.

Hubspot.GetCallDataByKeywords

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

Hubspot.GetCommunicationDataByKeywords

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

Hubspot.GetCompanyDataByKeywords

Retrieve company data with associated contacts, deals, calls, emails,

Hubspot.GetContactDataByKeywords

Retrieve contact data with associated companies, deals, calls, emails,

Hubspot.GetDeal

Retrieve a specific deal by its ID with associated contacts, companies, calls, emails,

Hubspot.GetDealById

Retrieve a specific deal by its ID with associated contacts, companies, calls, emails,

Hubspot.GetDealDataByKeywords

Retrieve deal data with associated contacts, companies, calls, emails,

Hubspot.GetDealPipelineStages

List stages for a specific HubSpot deal pipeline.

Hubspot.GetDealPipelines

List HubSpot deal pipelines with their stages, optionally filtered by a search string.

Hubspot.GetEmailDataByKeywords

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

Hubspot.GetMeetingDataByKeywords

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

Hubspot.GetNoteDataByKeywords

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

Hubspot.GetSystemGuidance

Get guidance and considerations for using the HubSpot toolkit effectively.

Hubspot.GetTaskDataByKeywords

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

Hubspot.GetUser

Get detailed information about a specific user/owner by their ID.

Hubspot.GetUserById

Get detailed information about a specific user/owner by their ID.

Hubspot.LinkActivityToDeal

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

Hubspot.LinkContactToDeal

Associate a contact with an existing deal in HubSpot.

Hubspot.ListCompanies

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

Hubspot.ListContacts

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

Hubspot.ListDealPipelines

List HubSpot deal pipelines with their stages, optionally filtered by a search string.

Hubspot.ListDealStages

List stages for a specific HubSpot deal pipeline.

Hubspot.ListDeals

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

Hubspot.ListIndustryTypes

Get all available industry types for HubSpot companies.

Hubspot.ListUsers

Get all users/owners in the HubSpot portal.

Hubspot.SearchCallActivities

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

Hubspot.SearchCommunicationActivities

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

Hubspot.SearchCompanies

Retrieve company data with associated contacts, deals, calls, emails,

Hubspot.SearchContacts

Retrieve contact data with associated companies, deals, calls, emails,

Hubspot.SearchDeals

Retrieve deal data with associated contacts, companies, calls, emails,

Hubspot.SearchEmailActivities

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

Hubspot.SearchMeetingActivities

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

Hubspot.SearchNoteActivities

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

Hubspot.SearchTaskActivities

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

Hubspot.ToolkitEnviromentGuidance

Get guidance and considerations for using the HubSpot toolkit effectively.

Hubspot.UpdateCallActivity

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

Hubspot.UpdateCommunicationActivity

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

Hubspot.UpdateCompany

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

Hubspot.UpdateContact

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

Hubspot.UpdateDeal

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

Hubspot.UpdateDealCloseDate

Update the expected close date of an existing deal with associated contacts, companies,

Hubspot.UpdateDealStage

Update a deal's stage with associated contacts, companies, calls, emails,

Hubspot.UpdateEmailActivity

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

Hubspot.UpdateMeetingActivity

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

Hubspot.UpdateNoteActivity

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

Hubspot.WhoAmI

Get current user information from HubSpot.

Working directly against the raw API? 769 more tools ship across 8 raw-API servers.

Why agent-optimized tools matter

Built for intent, not API schemas

Ask the agent to "find the Acme deal, show its contacts and recent activity, then update the close date." Arcade picks the right HubSpot tools without guessing record IDs or association IDs.

Up to 100x fewer tokens

HubSpot searches return matching records with associated contacts, companies, deals, and activities, so the agent can review CRM context without making separate lookups for every related record.

Complete the workflow end to end

Find the account, inspect its contacts, review the deal history, log the latest activity, and update the deal through one toolkit designed around the complete CRM task.

Make actions predictable and controlled

Arcade tools return structured results and useful errors across users and runs. Teams can apply scope restrictions, redaction, and approval policies so agents follow the same controls every time.

Securing HubSpot

The more capabilities agents get, the more useful they are. However, more capabilities bring more risks of undesired effects such as data loss and exfiltration.

This is why Arcade provides you with contextual rules that dictate how and when a tool is allowed to run. Arcade’s contextual access lets you govern tool visibility and behavior at every stage of execution and control who can see a tool, what inputs are allowed, and what comes back.

Learn about Contextual Access Policies

For HubSpot, you can implement some of these policies:

Access when tools are listed for a user
  • Hide Hubspot.CreateDeal from agents unless the roles your IDP marks as sales managers are active, so unapproved automation cannot create revenue records.
  • Restrict Hubspot.UpdateDealStage to agents operating under your opportunity-management role, so an agent cannot move deals into forecast or closed stages without the right access.
  • Deny Hubspot.CreateEmailActivity to read-only agents, so they cannot add email activity to customer records or create misleading engagement history.
  • Hide Hubspot.LinkActivityToDeal from agents outside the roles your IDP marks as sales operations owners, so unapproved automation cannot attach calls, emails, or notes to customer opportunities.
  • Restrict Hubspot.LinkContactToDeal to agents operating under your opportunity-management role, so an agent cannot associate an unrelated person with a deal.
Pre-execution before each tool call
  • Require human approval before Hubspot.CreateDeal runs, so an agent cannot create a deal with an incorrect amount, owner, or close date.
  • Block Hubspot.UpdateDealCloseDate when the requested date is earlier than today or falls outside your approved forecast window, so automation cannot distort pipeline reporting.
  • Require human approval before Hubspot.AssociateContactToDeal runs, so an agent cannot attach the wrong person to a customer opportunity.
  • Require human approval before Hubspot.LinkActivityToDeal runs, so an agent cannot add an inaccurate call, email, or note to a customer opportunity.
  • Block Hubspot.LinkContactToDeal when the contact is not already associated with the deal's company, so automation cannot attach the wrong person to an opportunity.
Post-execution after the tool returns
  • Redact message bodies, email addresses, phone numbers, and signatures from Hubspot.GetEmailDataByKeywords results before they reach the model.
  • Strip personal phone numbers, private email addresses, and street addresses from Hubspot.GetContactDataByKeywords results, so the model receives contact context without unnecessary personal data.
  • Redact login email addresses and phone numbers from Hubspot.GetAllUsers results, leaving names, roles, and owner IDs available for routing without exposing direct contact details.
  • Redact personal email addresses, phone numbers, and message bodies from Hubspot.SearchDeals results before they reach the model, leaving deal status and commercial fields available for analysis.
  • Strip private contact details and communication contents from Hubspot.SearchCompanies results, so the model receives company context without unnecessary personal data.
  • Deny Hubspot.SearchEmailActivities results when they contain legal-hold or confidential email content, so protected correspondence never reaches the model.

How to use HubSpot with your agent

Pick your MCP client below and follow the setup to connect HubSpot to your agent with per-user OAuth.

Your questions, answered

A HubSpot MCP server exposes HubSpot CRM capabilities as structured tools that an AI agent can call through the Model Context Protocol. After a user authorizes their HubSpot account, the agent can perform permitted actions such as searching CRM records, logging activities, and updating deals.

HubSpot's own MCP offering, where available, is a HubSpot-provided endpoint for CRM access. Arcade adds user-level OAuth, agent-optimized tools, approval workflows, redaction, and scope controls through one MCP gateway and tool API.

Arcade agents can search, list, read, create, and update companies, contacts, deals, and activity records. They can associate contacts and activities with deals, inspect pipelines and stages, update deal stages and close dates, and identify HubSpot users and owners.

Arcade requests the HubSpot OAuth permissions required by the actions you enable. Read-only workflows need read access to the relevant CRM records, while creating or updating records, activities, associations, stages, or close dates requires the corresponding write permissions; grant the narrowest permissions that support your workflow.

Yes. Each user authorizes their own HubSpot account through OAuth. HubSpot actions run under that user's authorization grant, so the agent can access only the portal data and permissions that user has approved.

Yes. Contextual Access policies can require human approval before consequential HubSpot actions such as creating or updating records, logging activities, changing deal stages, or updating close dates. The call proceeds only after the policy's conditions have been satisfied.

Arcade proxies HubSpot API calls and does not persist your content as part of normal tool execution. OAuth credentials are brokered and stored encrypted at rest, and the model never receives raw credentials.

Any framework or client that can connect to Arcade's MCP gateway or tool APIs works, including LangChain, OpenAI Agents, CrewAI, Claude Desktop, Claude Code, Cursor, Visual Studio Code, Microsoft Copilot Studio, and GitHub Copilot.

Arcade refreshes HubSpot access while the user's authorization remains valid. If access is revoked, rotated, or can no longer be refreshed, actions stop until the user reconnects their HubSpot account.

HubSpot API rate limits, quotas, and account-level restrictions still apply to actions performed through Arcade. The available details do not specify a separate Arcade limit, so design workflows to handle HubSpot throttling and retry responses.

Ready to actually ship your agent?

Connect your agent to HubSpot with managed OAuth, agent-optimized tools and approval controls for consequential actions.

Build Your Agent Read the HubSpot Quickstart