HubSpot MCP Server

What this does

HubSpot exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

HUBSPOT_CONFIG_DIR
HUBSPOT_ACCOUNT_EMAIL
MCP_WORKSPACE_PATH
HUBSPOT_CLIENT_ID
HUBSPOT_CLIENT_SECRET
HUBSPOT_SOURCE_LABEL
HUBSPOT_DISABLE_REFRESH
HUBSPOT_ALLOW_CLOUD_REFRESH
HUBSPOT_REQUEST_TIMEOUT_MS
HUBSPOT_REFRESH_LOCK_STALE_MS

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install HubSpot?

Run the Claude Code command in the install section to add HubSpot to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with HubSpot?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to HubSpot as well.

Does HubSpot need an API key?

Yes. Before it can run, set these environment variables: HUBSPOT_CONFIG_DIR, HUBSPOT_ACCOUNT_EMAIL, MCP_WORKSPACE_PATH, HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET, HUBSPOT_SOURCE_LABEL, HUBSPOT_DISABLE_REFRESH, HUBSPOT_ALLOW_CLOUD_REFRESH, HUBSPOT_REQUEST_TIMEOUT_MS, HUBSPOT_REFRESH_LOCK_STALE_MS. They go in the env block of your MCP config.