HubSpot MCP Server

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

Local serverstdio

What is the HubSpot MCP Server?

HubSpot is an MCP integration. HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads.

Packages and local setup

The published npm package is @mindstone/mcp-server-hubspot, version 0.4.1. Its declared MCP transport is stdio.

The package declares HUBSPOT_CONFIG_DIR (required): Directory containing accounts.json and credentials/.token.json; HUBSPOT_ACCOUNT_EMAIL (required): Account selector — one MCP process per HubSpot account; MCP_WORKSPACE_PATH: Workspace root for local file tools (required only when invoking upload/attach tools); HUBSPOT_CLIENT_ID (required): HubSpot OAuth client ID; HUBSPOT_CLIENT_SECRET (required): HubSpot OAuth client secret; HUBSPOT_SOURCE_LABEL: Source attribution label applied to new records; HUBSPOT_DISABLE_REFRESH: Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority); HUBSPOT_ALLOW_CLOUD_REFRESH: Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch); HUBSPOT_REQUEST_TIMEOUT_MS: Outbound HTTP request timeout in milliseconds (max 300000 = 5 min); HUBSPOT_REFRESH_LOCK_STALE_MS: Stale-lock detection threshold for the credential refresh mutex (advanced).

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.4.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related productivity & project management MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
HUBSPOT_CONFIG_DIRDirectory containing accounts.json and credentials/.token.jsonYes
HUBSPOT_ACCOUNT_EMAILAccount selector — one MCP process per HubSpot accountYes
MCP_WORKSPACE_PATHWorkspace root for local file tools (required only when invoking upload/attach tools)Optional
HUBSPOT_CLIENT_IDHubSpot OAuth client IDYes
HUBSPOT_CLIENT_SECRETHubSpot OAuth client secretYes
HUBSPOT_SOURCE_LABELSource attribution label applied to new recordsOptional
HUBSPOT_DISABLE_REFRESHSet to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)Optional
HUBSPOT_ALLOW_CLOUD_REFRESHSet to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)Optional
HUBSPOT_REQUEST_TIMEOUT_MSOutbound HTTP request timeout in milliseconds (max 300000 = 5 min)Optional
HUBSPOT_REFRESH_LOCK_STALE_MSStale-lock detection threshold for the credential refresh mutex (advanced)Optional