HubSpot

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.mindstone/mcp-server-hubspot",
  "description": "HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads",
  "title": "HubSpot",
  "repository": {
    "url": "https://github.com/mindstone/mcp-servers",
    "source": "github",
    "subfolder": "connectors/hubspot"
  },
  "version": "0.4.1",
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@mindstone/mcp-server-hubspot",
      "version": "0.4.1",
      "runtimeHint": "npx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Directory containing accounts.json and credentials/*.token.json",
          "isRequired": true,
          "format": "filepath",
          "name": "HUBSPOT_CONFIG_DIR"
        },
        {
          "description": "Account selector — one MCP process per HubSpot account",
          "isRequired": true,
          "format": "string",
          "name": "HUBSPOT_ACCOUNT_EMAIL"
        },
        {
          "description": "Workspace root for local file tools (required only when invoking upload/attach tools)",
          "format": "filepath",
          "name": "MCP_WORKSPACE_PATH"
        },
        {
          "description": "HubSpot OAuth client ID",
          "isRequired": true,
          "format": "string",
          "name": "HUBSPOT_CLIENT_ID"
        },
        {
          "description": "HubSpot OAuth client secret",
          "isRequired": true,
          "format": "string",
          "isSecret": true,
          "name": "HUBSPOT_CLIENT_SECRET"
        },
        {
          "description": "Source attribution label applied to new records",
          "format": "string",
          "default": "HubSpot MCP",
          "name": "HUBSPOT_SOURCE_LABEL"
        },
        {
          "description": "Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)",
          "format": "string",
          "name": "HUBSPOT_DISABLE_REFRESH"
        },
        {
          "description": "Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)",
          "format": "string",
          "name": "HUBSPOT_ALLOW_CLOUD_REFRESH"
        },
        {
          "description": "Outbound HTTP request timeout in milliseconds (max 300000 = 5 min)",
          "format": "number",
          "default": "60000",
          "name": "HUBSPOT_REQUEST_TIMEOUT_MS"
        },
        {
          "description": "Stale-lock detection threshold for the credential refresh mutex (advanced)",
          "format": "number",
          "name": "HUBSPOT_REFRESH_LOCK_STALE_MS"
        }
      ]
    }
  ],
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "com.mindstone.rebel": {
        "catalogId": "bundled-hubspot",
        "provider": "rebel-oss"
      }
    }
  }
}