Back to Tools
Sales & CRM OAuth
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

40 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.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.GetTaskDataByKeywords

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

Hubspot.GetUserById

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

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.ListDeals

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

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 stalled deals, review their latest activity, and suggest the next step." Arcade helps it use the right HubSpot tools without guessing deal IDs, contact IDs, or association types.

Up to 100x fewer tokens

HubSpot searches return records with related contacts, companies, deals, and activities, so the agent can inspect the relevant CRM context without loading the whole portal or separate activity histories.

Complete the workflow end to end

Find the right company, retrieve its contacts and deals, inspect recent activity, update the deal stage, and log the next interaction 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.
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.
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.

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 CRM capabilities as structured tools that an AI agent can call through the Model Context Protocol. After a user authorizes HubSpot, the agent can search and update contacts, companies, deals, and related activities.

HubSpot's own MCP server is a first-party endpoint for accessing HubSpot capabilities. Arcade adds per-user OAuth, agent-focused tools, approval workflows, response redaction, and scope controls through one MCP gateway for supported clients.

Arcade agents can search contacts, companies, deals, owners, pipelines, and activities; create contacts, companies, deals, notes, calls, meetings, communications, and logged emails; associate records; update CRM fields, deal stages, close dates, and activities; and return related records and activity history.

Arcade requests the HubSpot OAuth permissions required for the CRM records and activities your workflow uses. Read and write workflows need different HubSpot scopes, so grant only the CRM permissions needed for the actions you enable.

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

Yes. Contextual Access policies can require human approval before consequential HubSpot actions such as creating or updating a deal, changing its stage or close date, sending a logged communication, or creating an activity. The call proceeds only after the policy's conditions are satisfied.

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

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 access while the user's HubSpot authorization remains valid. If it is revoked, rotated, or can no longer be refreshed, calls stop until the user reconnects HubSpot.

HubSpot API rate limits and account or app quotas still apply to calls made through Arcade. Arcade does not remove those limits; plan workflows to avoid unnecessary searches and repeated updates.

Ready to actually ship your agent?

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