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 PoliciesFor HubSpot, you can implement some of these policies:
- 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.
- 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.
- 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.