English Français العربية

HubSpot

Registre officiel Marketing et ventes

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

Code source

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • HUBSPOT_CONFIG_DIR obligatoire Directory containing accounts.json and credentials/*.token.json
  • HUBSPOT_ACCOUNT_EMAIL obligatoire 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 obligatoire HubSpot OAuth client ID
  • HUBSPOT_CLIENT_SECRET obligatoire 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)

Questions fréquentes

Qu'est-ce que HubSpot ?

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

Comment installer HubSpot ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour HubSpot ?

Oui. Il attend HUBSPOT_CONFIG_DIR, HUBSPOT_ACCOUNT_EMAIL, HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET, à renseigner dans sa configuration.

HubSpot est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient HubSpot ?

Il est publié par mindstone. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.