AgentHubAgentHub

HubSpot

MCP ServerMCP Registry官方收录

io.github.mindstone/mcp-server-hubspot · v0.2.1

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

概览

HubSpot 是一个MCP Server,收录自 官方 MCP Registry。支持 stdio 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "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>",
        "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
        "HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>"
      }
    }
  }
}

环境变量

HUBSPOT_CONFIG_DIR必填

Directory containing accounts.json and credentials/*.token.json

HUBSPOT_ACCOUNT_EMAIL必填

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必填

HubSpot OAuth client ID

HUBSPOT_CLIENT_SECRET必填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_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)

相关资源

统一 Manifest

{
  "id": "io.github.mindstone/mcp-server-hubspot",
  "type": "mcp-server",
  "version": "0.2.1",
  "displayName": "HubSpot",
  "description": "HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads",
  "repository": {
    "url": "https://github.com/mindstone/mcp-servers",
    "source": "github",
    "subfolder": "connectors/hubspot"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@mindstone/mcp-server-hubspot",
        "version": "0.2.1",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "HUBSPOT_CONFIG_DIR",
            "description": "Directory containing accounts.json and credentials/*.token.json",
            "isRequired": true
          },
          {
            "name": "HUBSPOT_ACCOUNT_EMAIL",
            "description": "Account selector — one MCP process per HubSpot account",
            "isRequired": true
          },
          {
            "name": "MCP_WORKSPACE_PATH",
            "description": "Workspace root for local file tools (required only when invoking upload/attach tools)"
          },
          {
            "name": "HUBSPOT_CLIENT_ID",
            "description": "HubSpot OAuth client ID",
            "isRequired": true
          },
          {
            "name": "HUBSPOT_CLIENT_SECRET",
            "description": "HubSpot OAuth client secret",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "HUBSPOT_SOURCE_LABEL",
            "description": "Source attribution label applied to new records"
          },
          {
            "name": "HUBSPOT_DISABLE_REFRESH",
            "description": "Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)"
          },
          {
            "name": "HUBSPOT_ALLOW_CLOUD_REFRESH",
            "description": "Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)"
          },
          {
            "name": "HUBSPOT_REQUEST_TIMEOUT_MS",
            "description": "Outbound HTTP request timeout in milliseconds (max 300000 = 5 min)"
          },
          {
            "name": "HUBSPOT_SCOPE_TIER",
            "description": "OAuth scope tier — 'readonly' or 'full'. Overrides the per-account stored tier"
          },
          {
            "name": "HUBSPOT_REFRESH_LOCK_STALE_MS",
            "description": "Stale-lock detection threshold for the credential refresh mutex (advanced)"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.mindstone/mcp-server-hubspot",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.mindstone%2Fmcp-server-hubspot/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
HubSpot — MCP Server 安装与配置 · AgentHub