Set up HubSpot MCP in Claude Code
CRM data access, contact management, deal tracking, and company information from HubSpot. Official integration in public beta.
1
Locate the config file
Claude Code reads MCP server configuration from the following file:
~/.claude.jsonCreate this file if it does not already exist.
2
Add the configuration
You can configure HubSpot MCP using the CLI command or by editing the config file directly.
Option A: CLI command
bash
claude mcp add hubspot-mcp -e HUBSPOT_ACCESS_TOKEN=YOUR_HUBSPOT_ACCESS_TOKEN -- npx -y @hubspot/mcp-serverOption B: Config file
json
{
"mcpServers": {
"hubspot-mcp": {
"command": "npx",
"args": [
"-y",
"@hubspot/mcp-server"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}3
Set up environment variables
HubSpot MCP requires the following environment variables:
HUBSPOT_ACCESS_TOKENRequiredHubSpot private app access token
4
Verify it works
Restart Claude Code. HubSpot MCP should appear in your MCP server list with 10 tools available.
This server adds approximately 5,150 tokens to your context window for tool definitions.