HubSpot

Enables AI agents to read and update HubSpot CRM data through the Model Context Protocol. Supports contact and company lookup, deal pipeline management, ticket creation, and note logging. Ideal for sales automation, lead enrichment, and customer support workflows that use HubSpot as the system of record.

Package

Registry	npm (stdio)
Package	`@hubspot/mcp-server@0.4.0`
Integrity	`sha512-nNNrqysJrCkPb8XWl3wd2d61nTLf8IAnfWOHag4FCSRKRjSXuIE/2h4GVUcPmVhJVaN7RsIq8C43BMFV+EI9GA==`
Lockfile	package-lock.json `sha512-3seNHmlBpH8APD3huB/WPXmUAqPIipKAf1gkZVLDER/oPBf/TFYCc2LgCuIRosP1ytfUWuWA8sKepsZv0NegzQ==`
Entry	`dist/index.js`
Install scripts	none allowed

Configuration

Create a Private App in HubSpot and copy the access token with the minimum required scopes. — get credentials

Key	Name	Kind	Required	Secret	Format	Default / choices
`PRIVATE_APP_ACCESS_TOKEN`	HubSpot Private App Access Token Access token of a HubSpot private app	env	yes	yes	string

Tools (21)

From the test run on 2026-10-23 (darwin-arm64, linux-x64, Node 24) — needs credentials to start.

`hubspot-batch-create-associations`	params: fromObjectType, inputs, toObjectType, types
`hubspot-batch-create-objects`	params: inputs, objectType
`hubspot-batch-read-objects`	params: inputs, objectType, properties, propertiesWithHistory
`hubspot-batch-update-objects`	params: inputs, objectType
`hubspot-create-engagement`	params: associations, metadata, ownerId, timestamp, type
`hubspot-create-property`	params: calculationFormula, description, displayOrder, externalOptions, fieldType, formField, groupName, hasUniqueValue, hidden, label, name, objectType, options, type
`hubspot-generate-feedback-link`
`hubspot-get-association-definitions`	params: fromObjectType, toObjectType
`hubspot-get-engagement`	params: engagementId*
`hubspot-get-link`	params: pageRequests, portalId, uiDomain*
`hubspot-get-property`	params: objectType, propertyName
`hubspot-get-schemas`
`hubspot-get-user-details`
`hubspot-get-workflow`	params: flowId*
`hubspot-list-associations`	params: after, objectId, objectType, toObjectType*
`hubspot-list-objects`	params: after, archived, associations, limit, objectType*, properties
`hubspot-list-properties`	params: archived, includeHidden, objectType*
`hubspot-list-workflows`	params: after, limit
`hubspot-search-objects`	params: after, filterGroups, limit, objectType*, properties, query, sorts
`hubspot-update-engagement`	params: associations, engagementId, metadata*, ownerId, timestamp
`hubspot-update-property`	params: calculationFormula, description, displayOrder, fieldType, formField, groupName, hidden, label, objectType, options, propertyName, type

Security Assessment

Level	caution
Permissions	read:crm, write:crm, read:contacts, write:contacts
Data Exposure	content
Requires Supervisor	No
Risk Notes	Grants access to CRM records including contact PII. Use a scoped private app token with minimum required permissions.
Review	pass · official · 2026-03-16
Runtime	engines.node not declared · native modules: no · 14.9 MB installed

When to Use

Use	When agents need to enrich leads, update CRM records, log sales activities, or create support tickets in HubSpot.
Do not use	For CRM workflows that are not based on HubSpot, such as Salesforce.
Input / Output	text, json → json, text

com.forgeuno/hubspot-mcp · v0.4.0 · Category: productivity · Free tier: Yes · HubSpot CRM is free; API access available on all plans including free. · Source · Website