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
claude mcp add --transport http hubspot https://hubspot.run.toolsWhat 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.toolsPlatform CLI: remote server
codex mcp add hubspot-hubspot --url https://hubspot.run.toolsConfig file
{
"mcpServers": {
"hubspot-hubspot": {
"url": "https://hubspot.run.tools"
}
}
}Config file
{
"servers": {
"hubspot-hubspot": {
"type": "http",
"url": "https://hubspot.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http hubspot-hubspot https://hubspot.run.toolsStep 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.