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 (文字列): 分析データをグループ化する期間 (日次、週次、月次、四半期、年次)

  • startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）

• オプション入力:

  • endDate (文字列): 分析の終了日（ISO形式）

  • pipeline (文字列): フィルタリングするパイプラインID

  • dealStage (文字列): フィルタリングする取引ステージID

  • dealOwner (文字列): フィルタリングする取引所有者ID

• 返品: 期間別にグループ化された集計された売上指標

12. hubspot_get_deal_history

• 取引の変更履歴をすべて取得する

• 必要な入力:

  • dealId (文字列): 履歴を取得する取引のID

• 戻り値: タイムスタンプと変更されたプロパティを含む取引の変更履歴

13. hubspot_get_deal_notes

• 特定の取引に関連するメモを取得する

• 必要な入力:

  • dealId (文字列): メモを取得する取引のID

• オプション入力:

  • limit (数値、デフォルト: 20): 返されるノートの最大数

  • after (文字列): 次の結果ページのページネーションカーソル

• 戻り値: 内容と作成タイムスタンプを含むメモのリスト

14. hubspot_get_engagements_by_deal

• 取引に関連するすべてのエンゲージメントアクティビティを取得する

• 必要な入力:

  • dealId (文字列): エンゲージメントを取得する取引のID

• オプション入力:

  • types （配列）：含めるエンゲージメントの種類（電話、電子メール、会議、タスク、メモ）

  • limit （数値、デフォルト：20）：返されるエンゲージメントの最大数

  • after (文字列): 次の結果ページのページネーションカーソル

• 戻り値: エンゲージメントの詳細とタイプ情報のリスト

15. hubspot_get_sales_performance

• 特定の期間における営業担当者のパフォーマンス指標を取得する

• 必要な入力:

  • period (文字列): パフォーマンスデータをグループ化する期間 (日次、週次、月次、四半期、年次)

  • startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）

• オプション入力:

  • endDate (文字列): 分析の終了日（ISO形式）

  • ownerIds (配列): 分析に含める所有者IDのリスト

  • pipeline (文字列): フィルタリングするパイプラインID

• 収益: 取引件数、収益、成約率など、各営業担当者のパフォーマンス指標

16. hubspot_get_pipeline_analytics

• ステージ間のコンバージョン率など、特定の販売パイプラインの分析情報を取得します

• 必要な入力:

  • pipelineId (文字列): 分析するパイプラインのID

  • period (文字列): 分析データをグループ化する期間 (日次、週次、月次、四半期、年次)

  • startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）

• オプション入力:

  • endDate (文字列): 分析の終了日（ISO形式）

• 返されるもの: 取引数、価値、コンバージョン率、ステージ内の時間などのパイプラインステージ指標

17. hubspot_get_forecast_analytics

• 現在のパイプラインと過去のパフォーマンスに基づいて予測販売データを取得します

• 必要な入力:

  • period (文字列): 予測データをグループ化する期間 (月次、四半期、年次)

• オプション入力:

  • numberOfPeriods (数値、デフォルト: 3): 予測する将来の期間数

  • pipeline (文字列): フィルタリングするパイプラインID

• 収益: 過去のデータと現在のパイプラインに基づいて、将来の期間の予測販売指標

Related MCP server: HubSpot MCP Server

設定

1. HubSpotプライベートアプリを作成する:

   • HubSpotアカウントにアクセスしてください

   • 設定→アカウント設定→統合→プライベートアプリに移動します

   • 「プライベートアプリを作成」をクリックします

   • アプリに名前を付け、適切なスコープ（連絡先、取引、会社）を設定します

   • アプリを作成し、プライベートアプリトークンをコピーします

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"
      }
    }
  }
}

ドッカー

{
  "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ファイルをご覧ください。