Skip to main content
MCP server CX Codex

HubSpot · hubspot — Claude Code MCP server: what it does, how to install

Connects AI assistants to HubSpot CRM via remote HTTP. It lets you query contacts, inspect deal pipelines, and review support tickets in chat.

no license 1,166 installs updated 2025-11-19

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http hubspot https://hubspot.run.tools
Open on GitHub

What HubSpot does

The server operates through the remote endpoint at https://hubspot.run.tools. Before running operations, it invokes get_user_details to verify the account identity and check read or write permissions across CRM objects. This security step blocks unauthorized requests early.

Data retrieval relies on search_crm_objects for filtered queries and get_crm_objects for batch record lookups. The search call reports total record counts, which helps when exploring larger datasets. To inspect schemas, tools like get_properties and search_properties expose property definitions and valid enumeration choices.

HubSpot owner identifiers differ from standard user IDs. Lookups through search_owners only accept specific owner IDs, so using a regular user ID will fail.

What it helps with

  • search contacts and companies using filtered queries
  • inspect deal pipelines and track open tickets
  • fetch CRM property definitions and enumeration values
  • retrieve multiple records of the same type in a single call

Example prompts for the agent

  • Find all HubSpot contacts associated with Acme Corp and list their deals
  • Check the total count and status of all open support tickets
  • Inspect the property definitions and allowed values for lead status

How to install HubSpot

Platform CLI: remote server

claude mcp add --transport http hubspot https://hubspot.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about HubSpot

How to install HubSpot in Claude Code?

Run claude mcp add --transport http hubspot https://hubspot.run.tools in your terminal. This registers the remote HTTP endpoint in your Claude Code setup.

What does the HubSpot MCP server do?

It provides natural-language access to your HubSpot CRM records. Your assistant can query contacts, analyze deal pipelines, and inspect custom properties directly from the workspace.

Why does the server require get_user_details first?

It must identify the user and confirm their read and write access levels before executing queries. This ensures the assistant respects CRM account permissions.

Similar MCP servers

All MCP servers for Marketing and content →

HubSpot by other authors comes first.

HubSpot mindstone Connects the agent to HubSpot CRM. Search and create contacts, deals, tickets, tasks, notes and files without leaving the chat. CX Codex +1 ★ 14repo stars HubSpot docker HubSpot connects marketing, sales, and customer service to your AI assistant with lead management, automation, and analytics. CX Codex +1 hubspot-sales-audit tomgranot hubspot-sales-audit is a Claude Code skill for auditing HubSpot sales pipelines, deal data quality, stale deals and overdue deals. It makes no CRM changes. CX Codex +1 ★ 81repo stars hubspot-sales HubSpot hubspot-sales brings the sales workflow into Claude: import contacts and deals, get a morning brief, prep for calls, draft follow-ups. Changes go back to HubSpot. ★ 5repo stars hubspot-automation davepoon hubspot-automation automates HubSpot CRM workflows covering contacts, deals, companies, and tickets via Rube MCP and Composio. CX Codex +1 126installs enrich-company-name tomgranot enrich-company-name copies the company name from a linked company record into empty contact fields in HubSpot. Useful when empty values break segmentation and personalization tokens. CX Codex +1 ★ 81repo stars sales-execution HubSpot sales-execution logs calls, notes, meetings, and tasks in HubSpot CRM via the CLI. Links every entry to contacts and deals so records appear in the UI. CX Codex +1 1,900installs call-list official anthropics call-list ranks your leads for today, pulls talking points from email history, blocks calendar time and drafts follow-ups. Built for sales that run on calls. CX Codex +1 1,800installs

More in the catalog

Project sponsors

Companies that keep this analytics open