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 (文字列): 分析データをグループ化する期間 (日次、週次、月次、四半期、年次)
  • 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
• 収益: 過去のデータと現在のパイプラインに基づいて、将来の期間の予測販売指標

設定

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

ドッカー

トラブルシューティング

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

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

建てる

Dockerビルド:

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。