Skip to content
skillsaggregatorskillsaggregator
Privacy: This guide links directly to HubSpot's credential pages. We never ask you to enter, store, or transmit any credential through this site. Zero outbound calls to anything but the vendor's docs.

HubSpot MCP — Auth Setup

HubSpot uses private app access tokens to authenticate API requests to your portal.

1. Get your credentials

  1. Open the HubSpot Private Apps page (opens HubSpot — we never see your token)
  2. Click Create a private app, configure the required scopes, and click Create app
  3. Copy the Access token from the app detail page — treat it like a password

2. Set environment variables

macOS / Linux — add to ~/.zshrc or ~/.bashrc:

export HUBSPOT_ACCESS_TOKEN=YOUR_ACCESS_TOKEN_HERE

Then run source ~/.zshrc (or open a new terminal).

Windows — run in Command Prompt (then restart):

setx HUBSPOT_ACCESS_TOKEN "YOUR_ACCESS_TOKEN_HERE"

3. Verify

npx claude-skills doctor

You should see ✅ next to the HubSpot MCP entry. If you see ❌, confirm the token is set: echo $HUBSPOT_ACCESS_TOKEN.

4. Restart Claude Code

Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the HubSpot MCP appears).