English Français العربية

HubSpot

Official registry Marketing and sales

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @mindstone/mcp-server-hubspot
Claude Code 
claude mcp add hubspot -e 'HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR>' -e 'HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL>' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -e 'HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID>' -e 'HUBSPOT_CLIENT_SECRET=<your hubspot_client_secret>' -e 'HUBSPOT_SOURCE_LABEL=HubSpot MCP' -e 'HUBSPOT_DISABLE_REFRESH=<HUBSPOT_DISABLE_REFRESH>' -e 'HUBSPOT_ALLOW_CLOUD_REFRESH=<HUBSPOT_ALLOW_CLOUD_REFRESH>' -e 'HUBSPOT_REQUEST_TIMEOUT_MS=60000' -e 'HUBSPOT_REFRESH_LOCK_STALE_MS=<HUBSPOT_REFRESH_LOCK_STALE_MS>' -- npx -y @mindstone/mcp-server-hubspot@0.4.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hubspot": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-hubspot@0.4.1"
            ],
            "env": {
                "HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>",
                "HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
                "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
                "HUBSPOT_CLIENT_SECRET": "<your hubspot_client_secret>",
                "HUBSPOT_SOURCE_LABEL": "HubSpot MCP",
                "HUBSPOT_DISABLE_REFRESH": "<HUBSPOT_DISABLE_REFRESH>",
                "HUBSPOT_ALLOW_CLOUD_REFRESH": "<HUBSPOT_ALLOW_CLOUD_REFRESH>",
                "HUBSPOT_REQUEST_TIMEOUT_MS": "60000",
                "HUBSPOT_REFRESH_LOCK_STALE_MS": "<HUBSPOT_REFRESH_LOCK_STALE_MS>"
            }
        }
    }
}

Environment variables

  • HUBSPOT_CONFIG_DIR required Directory containing accounts.json and credentials/*.token.json
  • HUBSPOT_ACCOUNT_EMAIL required Account selector — one MCP process per HubSpot account
  • MCP_WORKSPACE_PATH Workspace root for local file tools (required only when invoking upload/attach tools)
  • HUBSPOT_CLIENT_ID required HubSpot OAuth client ID
  • HUBSPOT_CLIENT_SECRET required secret HubSpot OAuth client secret
  • HUBSPOT_SOURCE_LABEL Source attribution label applied to new records
  • HUBSPOT_DISABLE_REFRESH Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)
  • HUBSPOT_ALLOW_CLOUD_REFRESH Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)
  • HUBSPOT_REQUEST_TIMEOUT_MS Outbound HTTP request timeout in milliseconds (max 300000 = 5 min)
  • HUBSPOT_REFRESH_LOCK_STALE_MS Stale-lock detection threshold for the credential refresh mutex (advanced)

Frequently asked questions

What is HubSpot?

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

How do I install HubSpot?

It runs on your machine. In Claude Code: claude mcp add hubspot -e 'HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR>' -e 'HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL>' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -e 'HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID>' -e 'HUBSPOT_CLIENT_SECRET=<your hubspot_client_secret>' -e 'HUBSPOT_SOURCE_LABEL=HubSpot MCP' -e 'HUBSPOT_DISABLE_REFRESH=<HUBSPOT_DISABLE_REFRESH>' -e 'HUBSPOT_ALLOW_CLOUD_REFRESH=<HUBSPOT_ALLOW_CLOUD_REFRESH>' -e 'HUBSPOT_REQUEST_TIMEOUT_MS=60000' -e 'HUBSPOT_REFRESH_LOCK_STALE_MS=<HUBSPOT_REFRESH_LOCK_STALE_MS>' -- npx -y @mindstone/mcp-server-hubspot@0.4.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does HubSpot need an API key?

Yes. It expects HUBSPOT_CONFIG_DIR, HUBSPOT_ACCOUNT_EMAIL, HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET, which you set in its configuration.

Is HubSpot open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains HubSpot?

It is published by mindstone. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.