HubSpot

mindstone/mcp-servers

Gives you MCP access to HubSpot's CRM through the Web API. You can manage contacts, companies, deals, tickets, leads, tasks, and notes, plus work with properties, lists, workflows, the knowledge base, and file uploads. Built by Mindstone with multi-account support and host-orchestrated OAuth, so you can switch between portals without manually juggling tokens. Reach for this when you need an LLM to pull deal stage data, update contact properties in bulk, or draft ticket replies based on CRM context. It's part of a 35-connector monorepo that shares auth patterns and hardening practices across Google Workspace, Slack, Salesforce, and others.

tools: 7
auth: Secret needed
transport: STDIO
env vars: 10
last updated: Aug 8, 2026

View on GitHub

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

search_crm_objectsSearches and retrieves CRM records from HubSpot based on filters and criteria. <capabilities> - Returns a 'total' count attribute that can help perform analytical tasks on large datasets - Useful to sample data from a specific object type to understand the data model - Can lis...8 params

Searches and retrieves CRM records from HubSpot based on filters and criteria. <capabilities> - Returns a 'total' count attribute that can help perform analytical tasks on large datasets - Useful to sample data from a specific object type to understand the data model - Can lis...

Parameters* required

chatInsightsobject

Insights about the chat including user intent and satisfaction level. IMPORTANT: MUST be provided for all scenarios.

filterGroupsarray

* The filter groups that define the search criteria. * Filters that match ALL of several conditions (AND logic) should be put in the same filterGroup. * Filters that match AT LEAST ONE of several...

limitinteger

Maximum number of results per page. Max: 200, Default: 100

objectTypestring

Mandatory field specifying ObjectType to search for objects for.

offsetinteger

Paging cursor token for pagination

propertiesarray

Optional list of property names to include in results. Returns default set if empty. Specify the minimum set of properties needed for the task for best results. Leave it empty only if you explicitl...

querystring

Optional text to search for within the default searchable properties of the specified object type. Uses simple text matching (contains) Each object type has different searchable properties. contact...

sortsarray

Optional sorting rules for results. Only one sort rule can be applied

get_propertiesFetches property definitions including data types and enumeration values. <capabilities> - Particularly useful for discovering valid options in enumeration-type properties - To search for actual data, use search_crm_objects </capabilities> <returns> List of property definition...2 params

Fetches property definitions including data types and enumeration values. <capabilities> - Particularly useful for discovering valid options in enumeration-type properties - To search for actual data, use search_crm_objects </capabilities> <returns> List of property definition...

Parameters* required

objectTypestring

The object type to get properties for. e.g., contacts, companies, deals, tickets, etc.

propertyNamesarray

The set of property names to retrieve

submit_feedbackCollects and submits feedback to HubSpot on dissatisfaction or user request. <when_to_invoke> <agent_detected_signals> - User provides explicit correction: "No, I meant...", "Actually, I want..." - User repeats query with different phrasing - User states something is wrong: "T...5 params

Collects and submits feedback to HubSpot on dissatisfaction or user request. <when_to_invoke> <agent_detected_signals> - User provides explicit correction: "No, I meant...", "Actually, I want..." - User repeats query with different phrasing - User states something is wrong: "T...

Parameters* required

explanationOfSatisfactionstring

Brief reasoning for the perceived satisfaction. Examples: 'User corrected the agent twice', 'User expressed gratitude for the help', 'Neutral conversation with no strong signals'. When errors occu...

feedbackstring

User's verbatim feedback. NEVER paraphrase - use the user's exact words if they provided feedback. Avoid PII - use anonymized references.

goalstring

User's goal or what they were trying to accomplish and relevant conversation context. Avoid PII - use anonymized references. Important: Avoid adding extraneous information, especially from memory.

satisfactionstring

Perceived overall satisfaction of the feedbackone of DISSATISFIED · NEUTRAL · SATISFIED

triggeringToolNamestring

Name of the tool related to this feedback

search_ownersLists and searches for owners who can be assigned to CRM records. <capabilities> - Supports searching by name/email or batch lookup by owner IDs - HubSpot owner ids and user IDs are distinct, lookups only work when owner ids are provided specifically </capabilities> <returns>...4 params

Lists and searches for owners who can be assigned to CRM records. <capabilities> - Supports searching by name/email or batch lookup by owner IDs - HubSpot owner ids and user IDs are distinct, lookups only work when owner ids are provided specifically </capabilities> <returns>...

Parameters* required

limitinteger

Maximum number of results to return. Defaults to 25, max 100

offsetinteger

Offset for pagination. Defaults to 0

ownerIdsarray

Optional list of owner IDs to lookup directly. When provided, search query is ignored

searchQuerystring

Optional search query to find owners by name or email. Returns all owners if not provided

search_propertiesFinds the most relevant CRM property definitions using keyword-based search. <capabilities> - Lists all property definitions for specified object type when no search terms provided - To search for actual data, use search_crm_objects </capabilities> <returns> A filtered list of...3 params

Finds the most relevant CRM property definitions using keyword-based search. <capabilities> - Lists all property definitions for specified object type when no search terms provided - To search for actual data, use search_crm_objects </capabilities> <returns> A filtered list of...

Parameters* required

keywordsarray

Multiple search keywords (max 5) to find relevant properties using efficient keyword-based search. Supports searching for multiple related property concepts in a single request. Examples: - ["urge...

objectTypestring

The name of the object type to search properties for

querystring

DEPRECATED: Use keywords instead. Single search keyword for backward compatibility. If both query and keywords are provided, keywords takes precedence. If empty and no keywords provided, returns al...

get_crm_objectsFetches multiple CRM objects of the same object type in a single request. <returns> A list of CRM objects with their properties, identified by their unique IDs, containing: - id: Unique identifier for the CRM object - properties: Key-value pairs of property names and their val...3 params

Fetches multiple CRM objects of the same object type in a single request. <returns> A list of CRM objects with their properties, identified by their unique IDs, containing: - id: Unique identifier for the CRM object - properties: Key-value pairs of property names and their val...

Parameters* required

objectIdsarray

List of object IDs to fetch. Min: 1, Max: 100

objectTypestring

Object type to fetch

propertiesarray

List of CRM Properties to include in the response

get_user_detailsReturns user and hub info; CRM/marketing object read/write availability. <usage_guidance> - This tool must be used before performing any operations with Hubspot tools to determine the identity of the user, and permissions they have on their Hubspot account - This tool only ret...

Returns user and hub info; CRM/marketing object read/write availability. <usage_guidance> - This tool must be used before performing any operations with Hubspot tools to determine the identity of the user, and permissions they have on their Hubspot account - This tool only ret...

No parameter schema in public metadata yet.

Configuration

HUBSPOT_CONFIG_DIR*

Directory containing accounts.json and credentials/*.token.json

HUBSPOT_ACCOUNT_EMAIL*

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*

HubSpot OAuth client ID

HUBSPOT_CLIENT_SECRET*secret

HubSpot OAuth client secret

HUBSPOT_SOURCE_LABELdefault: HubSpot MCP

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_MSdefault: 60000

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)

Readme

Rogue, the Rebel character for safe action and control

mcp-servers

Source-available MCP servers by Mindstone. Works with any MCP host — Claude Desktop, Cursor, Rebel, and others.

Browse all 35 connectors with their version, auth model, and tool count at the catalogue site (regenerated from each connector's STATUS.json on every push).

Connectors

View the full README on GitHub

Details

Repository: github.com/mindstone/mcp-servers
Categories: Sales & Marketing, Communication & Messaging, Finance & Commerce
Package: @mindstone/mcp-server-hubspot
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Sales & Marketing MCP servers

View all

FastMCP server for Apolloadelaidasofia/apollo-mcpFastMCP server for Apollo.io — 22 tools: sequences, campaign health, mailbox warmup, enrichment,…1stars

Apollo.io MCP Serverinferensys/apollo-io-mcpApollo.io MCP server for prospecting, enrichment, CRM, sequences, and outreach workflows1stars

Dingdawg Marketing Agentdingdawg/dingdawg-agent-1AI content generation, SEO audits, campaign planning & social scheduling.0stars

Dingdawg Sales Agentdingdawg/dingdawg-agent-1AI prospect research, outreach drafting, lead scoring & pipeline tracking.0stars

Mcp Gtm Tech Stack Signal Scrapermambalabsdev/mcp-gtm-tech-stack-signal-scraperDetects a company CRM, sequencer, and marketing automation from its public website. Clay-ready.1stars

Revenue Enablement Mcpshashwatgtm/revenue-enablement-mcpRevenue Enablement: 12 deal and sales enablement tools by Helix GTM Consulting1stars

HubSpot

Tools

Configuration

Readme

mcp-servers

Connectors

Details

More from mindstone

Related Sales & Marketing MCP servers