HubSpot

io.github.mindstone/mcp-server-hubspot·v0.2.0·CRM & Sales

Quality Score

/100

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

Repository →

§00 Trust verdict · v1 advisory · method

UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "mcp-server-hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "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_SCOPE_TIER": "<hubspot_scope_tier>",
        "HUBSPOT_REFRESH_LOCK_STALE_MS": "<hubspot_refresh_lock_stale_ms>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "mcp-server-hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "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_SCOPE_TIER": "<hubspot_scope_tier>",
        "HUBSPOT_REFRESH_LOCK_STALE_MS": "<hubspot_refresh_lock_stale_ms>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y @mindstone/mcp-server-hubspot

§02 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

requiredsecret

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_SCOPE_TIER

OAuth scope tier — 'readonly' or 'full'. Overrides the per-account stored tier

HUBSPOT_REFRESH_LOCK_STALE_MS

Stale-lock detection threshold for the credential refresh mutex (advanced)

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in CRM & Sales

Cirra AI Salesforce Admin MCP Server

ai.cirra/salesforce-mcp

Comprehensive Salesforce administration and data management capabilities

ai.smithery/Funding-Machine-ghl-mcp-fundingmachine

Automate GoHighLevel across CRM, messaging, calendars, marketing, e-commerce, and billing. Manage…

ai.smithery/kaszek-kaszek-attio-mcp

Automate Attio CRM workflows with fast search and bulk operations across companies, people, deals,…