HubSpot MCP Server

HubSpot MCP サーバー

HubSpot API 用の MCP サーバーです。Claude が HubSpot CRM を操作し、営業分析やインサイトを得られるようにします。

免責事項

このオープンソースプロジェクトは、HubSpot とは提携しておらず、HubSpot の承認を受けたものでもありません。HubSpot の API と連携する独立した実装です。

ツール

CRM の基本ツール

1. hubspot_search_contacts

   • クエリ文字列を使って HubSpot 内のコンタクトを検索します
   • 必須入力：
     • query（文字列）：検索クエリ文字列（メールアドレス、名前など）
   • 任意入力：
     • count（数値、デフォルト：10）：返すコンタクトの最大数
     • propertyList（配列）：結果に含めるプロパティの一覧
   • 戻り値：一致するプロパティを含むコンタクトの一覧

2. hubspot_get_contact

   • ID で特定のコンタクトを取得します
   • 必須入力：
     • contactId（文字列）：取得するコンタクトの ID
   • 任意入力：
     • properties（配列）：結果に含めるプロパティの一覧
   • 戻り値：指定したプロパティを含むコンタクトの詳細

3. hubspot_create_contact

   • HubSpot に新しいコンタクトを作成します
   • 必須入力：
     • properties（オブジェクト）：少なくとも email フィールドを含むコンタクトのプロパティ
   • 戻り値：作成したコンタクトの詳細

4. hubspot_update_contact

   • HubSpot の既存のコンタクトを更新します
   • 必須入力：
     • contactId（文字列）：更新するコンタクトの ID
     • properties（オブジェクト）：更新するコンタクトのプロパティ
   • 戻り値：コンタクトの更新確認

5. hubspot_list_deals

   • ページネーションを使って HubSpot の取引を一覧表示します
   • 任意入力：
     • limit（数値、デフォルト：10、最大：100）：返す取引の最大数
     • after（文字列）：次のページを取得するためのページネーションカーソル
     • properties（配列）：結果に含めるプロパティの一覧
   • 戻り値：詳細を含む取引の一覧

6. hubspot_get_deal

   • ID で特定の取引を取得します
   • 必須入力：
     • dealId（文字列）：取得する取引の ID
   • 任意入力：
     • properties（配列）：結果に含めるプロパティの一覧
   • 戻り値：指定したプロパティを含む取引の詳細

7. hubspot_create_deal

   • HubSpot に新しい取引を作成します
   • 必須入力：
     • properties（オブジェクト）：少なくとも dealname フィールドを含む取引のプロパティ
   • 戻り値：作成した取引の詳細

8. hubspot_update_deal

   • HubSpot の既存の取引を更新します
   • 必須入力：
     • dealId（文字列）：更新する取引の ID
     • properties（オブジェクト）：更新する取引のプロパティ
   • 戻り値：取引の更新確認

9. hubspot_list_companies

   • ページネーションを使って HubSpot の会社を一覧表示します
   • 任意入力：
     • limit（数値、デフォルト：10、最大：100）：返す会社の最大数
     • after（文字列）：次のページを取得するためのページネーションカーソル
     • properties（配列）：結果に含めるプロパティの一覧
   • 戻り値：詳細を含む会社の一覧

10. hubspot_get_company

    • ID で特定の会社を取得します
    • 必須入力：
      • companyId（文字列）：取得する会社の ID
    • 任意入力：
      • properties（配列）：結果に含めるプロパティの一覧
    • 戻り値：指定したプロパティを含む会社の詳細

営業分析ツール

11. hubspot_get_sales_analytics

    • 指定した期間の集計済み営業分析データを取得します
    • 必須入力：
      • period (string)：分析データを集計する期間（日次、週次、月次、四半期ごと、年次）
      • startDate (string)：分析の開始日（ISO 形式、YYYY-MM-DD）
    • 任意入力：
      • endDate (string)：分析の終了日（ISO 形式）
      • pipeline (string)：絞り込み対象のパイプライン ID
      • dealStage (string)：絞り込み対象の取引ステージ ID
      • dealOwner (string)：絞り込み対象の取引オーナー ID
    • 戻り値：期間ごとに集計された営業指標

12. hubspot_get_deal_history

    • 取引の変更履歴全体を取得します
    • 必須入力：
      • dealId (string)：履歴を取得する取引の ID
    • 戻り値：タイムスタンプと変更されたプロパティを含む取引の変更履歴

13. hubspot_get_deal_notes

    • 特定の取引に関連付けられたメモを取得します
    • 必須入力：
      • dealId (string)：メモを取得する取引の ID
    • 任意入力：
      • limit (number, default: 20)：返すメモの最大件数
      • after (string)：次の結果ページを取得するためのページネーションカーソル
    • 戻り値：内容と作成タイムスタンプを含むメモの一覧

14. hubspot_get_engagements_by_deal

    • 取引に関連付けられたすべてのエンゲージメントアクティビティを取得します
    • 必須入力：
      • dealId (string)：エンゲージメントを取得する取引の ID
    • 任意入力：
      • types (array)：含めるエンゲージメントの種類（CALL、EMAIL、MEETING、TASK、NOTE）
      • limit (number, default: 20)：返すエンゲージメントの最大件数
      • after (string)：次の結果ページを取得するためのページネーションカーソル
    • 戻り値：詳細と種類の情報を含むエンゲージメントの一覧

15. hubspot_get_sales_performance

    • 指定した期間における営業担当者のパフォーマンス指標を取得します
    • 必須入力：
      • period (string)：パフォーマンスデータを集計する期間（日次、週次、月次、四半期ごと、年次）
      • startDate (string)：分析の開始日（ISO 形式、YYYY-MM-DD）
    • 任意入力：
      • endDate (string)：分析の終了日（ISO 形式）
      • ownerIds (array)：分析に含めるオーナー ID の一覧
      • pipeline (string)：絞り込み対象のパイプライン ID
    • 戻り値：取引件数、収益、成約率など、各営業担当者のパフォーマンス指標

16. hubspot_get_pipeline_analytics

    • 特定の営業パイプラインの分析データを、ステージ間のコンバージョン率を含めて取得します
    • 必須入力：
      • pipelineId (string)：分析するパイプラインの ID
      • period (string)：分析データを集計する期間（日次、週次、月次、四半期ごと、年次）
      • startDate (string)：分析の開始日（ISO 形式、YYYY-MM-DD）
    • 任意入力：
      • endDate (string)：分析の終了日（ISO 形式）
    • 戻り値：取引件数、金額、コンバージョン率、ステージ滞在期間などのパイプラインステージ指標

17. hubspot_get_forecast_analytics

    • 現在のパイプラインと過去の実績に基づいて、売上予測データを取得します
    • 必須入力：
      • period (string)：予測データを集計する期間（月次、四半期ごと、年次）
    • 任意入力：
      • numberOfPeriods (number, default: 3)：予測する将来の期間数
      • pipeline (string)：絞り込み対象のパイプライン ID
    • 戻り値：過去のデータと現在のパイプラインに基づく、将来の期間の売上予測指標

セットアップ

1. HubSpot のプライベートアプリを作成します。

   • HubSpot アカウントに移動します
   • 「Settings」→「Account Setup」→「Integrations」→「Private Apps」の順に移動します
   • 「Create private app」をクリックします
   • アプリに名前を付け、適切なスコープ（contacts、deals、companies）を設定します
   • アプリを作成し、プライベートアプリのトークンをコピーします

2. 必要なスコープ：

   • crm.objects.contacts.read
   • crm.objects.contacts.write
   • crm.objects.deals.read
   • crm.objects.deals.write
   • crm.objects.companies.read
   • crm.objects.companies.write
   • crm.objects.owners.read
   • crm.objects.quotes.read
   • crm.objects.line_items.read
   • crm.objects.custom.read
   • crm.schemas.deals.read
   • crm.schemas.contacts.read
   • crm.schemas.companies.read
   • crm.schemas.custom.read

Claude Desktop での使用方法

次の内容を claude_desktop_config.json に追加します。

npx

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

トラブルシューティング

エラーが発生した場合は、次の点を確認してください。

1. 必要なスコープがすべて HubSpot のプライベートアプリに追加されていること
2. API キーが設定に正しくコピーされていること
3. HubSpot のプランに、使用しようとしている API へのアクセスが含まれていること

ビルド

Docker ビルド：

docker build -t mcp/hubspot -f Dockerfile .

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。つまり、MIT ライセンスの利用規約に従うことを条件に、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。