HubSpot MCP サーバー

HubSpot API 用の MCP サーバー。これにより、Claude は HubSpot CRM と連携して販売分析や洞察を得ることができます。

免責事項
このオープンソースプロジェクトは、HubSpotと提携関係になく、HubSpotの承認も受けていません。HubSpotのAPIと連携する独立した実装です。

ツール

コアCRMツール

hubspot_search_contacts
- クエリ文字列を使用してHubSpotで連絡先を検索する
- 必要な入力:
  - query (文字列): 検索クエリ文字列 (メール、名前など)
- オプション入力:
  - count （数値、デフォルト：10）：返される連絡先の最大数
  - propertyList (配列): 結果に含めるプロパティのリスト
- 戻り値: 一致する連絡先とそのプロパティのリスト
hubspot_get_contact
- IDで特定の連絡先を取得する
- 必要な入力:
  - contactId (文字列): 取得する連絡先のID
- オプション入力:
  - properties (配列): 結果に含めるプロパティのリスト
- 返されるもの: 指定されたプロパティを持つ連絡先の詳細
hubspot_create_contact
- HubSpotで新しい連絡先を作成する
- 必要な入力:
  - properties （オブジェクト）：少なくともemailフィールドを持つ連絡先プロパティ
- 返品: 作成された連絡先の詳細
hubspot_update_contact
- HubSpotで既存の連絡先を更新する
- 必要な入力:
  - contactId (文字列): 更新する連絡先のID
  - properties (オブジェクト): 更新する連絡先のプロパティ
- 返品: 連絡先確認を更新しました
hubspot_list_deals
- HubSpotでページネーションを使用して取引を一覧表示する
- オプション入力:
  - limit （数値、デフォルト：10、最大：100）：返される取引の最大数
  - after (文字列): 次のページのページネーションカーソル
  - properties (配列): 結果に含めるプロパティのリスト
- 戻り値: 取引の詳細を含むリスト
hubspot_get_deal
- IDで特定の取引を取得する
- 必要な入力:
  - dealId (文字列): 取得する取引のID
- オプション入力:
  - properties (配列): 結果に含めるプロパティのリスト
- 戻り値: 指定されたプロパティを持つ取引の詳細
hubspot_create_deal
- HubSpotで新しい取引を作成する
- 必要な入力:
  - properties (オブジェクト): 少なくともdealnameフィールドを持つ取引プロパティ
- 返品: 作成された取引の詳細
hubspot_update_deal
- HubSpotで既存の取引を更新する
- 必要な入力:
  - dealId (文字列): 更新する取引のID
  - properties (オブジェクト): 更新する取引プロパティ
- 返品: 取引確認を更新しました
hubspot_list_companies
- HubSpotでページ区切りを使用して企業をリストする
- オプション入力:
  - limit （数値、デフォルト：10、最大：100）：返される企業の最大数
  - after (文字列): 次のページのページネーションカーソル
  - properties (配列): 結果に含めるプロパティのリスト
- 戻り値: 企業の詳細を含むリスト
hubspot_get_company

IDで特定の会社を取得する
必要な入力:
- companyId (文字列): 取得する会社のID
オプション入力:
- properties (配列): 結果に含めるプロパティのリスト
返される値: 指定されたプロパティを持つ会社の詳細

営業分析ツール

hubspot_get_sales_analytics

特定の期間の集計された売上分析データを取得する
必要な入力:
- period (文字列): 分析データをグループ化する期間 (日次、週次、月次、四半期、年次)
- startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）
オプション入力:
- endDate (文字列): 分析の終了日（ISO形式）
- pipeline (文字列): フィルタリングするパイプラインID
- dealStage (文字列): フィルタリングする取引ステージID
- dealOwner (文字列): フィルタリングする取引所有者ID
返品: 期間別にグループ化された集計された売上指標

hubspot_get_deal_history

取引の変更履歴をすべて取得する
必要な入力:
- dealId (文字列): 履歴を取得する取引のID
戻り値: タイムスタンプと変更されたプロパティを含む取引の変更履歴

hubspot_get_deal_notes

特定の取引に関連するメモを取得する
必要な入力:
- dealId (文字列): メモを取得する取引のID
オプション入力:
- limit (数値、デフォルト: 20): 返されるノートの最大数
- after (文字列): 次の結果ページのページネーションカーソル
戻り値: 内容と作成タイムスタンプを含むメモのリスト

hubspot_get_engagements_by_deal

取引に関連するすべてのエンゲージメントアクティビティを取得する
必要な入力:
- dealId (文字列): エンゲージメントを取得する取引のID
オプション入力:
- types （配列）：含めるエンゲージメントの種類（電話、電子メール、会議、タスク、メモ）
- limit （数値、デフォルト：20）：返されるエンゲージメントの最大数
- after (文字列): 次の結果ページのページネーションカーソル
戻り値: エンゲージメントの詳細とタイプ情報のリスト

hubspot_get_sales_performance

特定の期間における営業担当者のパフォーマンス指標を取得する
必要な入力:
- period (文字列): パフォーマンスデータをグループ化する期間 (日次、週次、月次、四半期、年次)
- startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）
オプション入力:
- endDate (文字列): 分析の終了日（ISO形式）
- ownerIds (配列): 分析に含める所有者IDのリスト
- pipeline (文字列): フィルタリングするパイプラインID
収益: 取引件数、収益、成約率など、各営業担当者のパフォーマンス指標

hubspot_get_pipeline_analytics

ステージ間のコンバージョン率など、特定の販売パイプラインの分析情報を取得します
必要な入力:
- pipelineId (文字列): 分析するパイプラインのID
- period (文字列): 分析データをグループ化する期間 (日次、週次、月次、四半期、年次)
- startDate (文字列): 分析の開始日（ISO形式、YYYY-MM-DD）
オプション入力:
- endDate (文字列): 分析の終了日（ISO形式）
返されるもの: 取引数、価値、コンバージョン率、ステージ内の時間などのパイプラインステージ指標

hubspot_get_forecast_analytics

現在のパイプラインと過去のパフォーマンスに基づいて予測販売データを取得します
必要な入力:
- period (文字列): 予測データをグループ化する期間 (月次、四半期、年次)
オプション入力:
- numberOfPeriods (数値、デフォルト: 3): 予測する将来の期間数
- pipeline (文字列): フィルタリングするパイプラインID
収益: 過去のデータと現在のパイプラインに基づいて、将来の期間の予測販売指標

設定

HubSpotプライベートアプリを作成する:
- HubSpotアカウントにアクセスしてください
- 設定→アカウント設定→統合→プライベートアプリに移動します
- 「プライベートアプリを作成」をクリックします
- アプリに名前を付け、適切なスコープ（連絡先、取引、会社）を設定します
- アプリを作成し、プライベートアプリトークンをコピーします
必要なスコープ:
- 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"
      }
    }
  }
}

トラブルシューティング

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

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

建てる

Dockerビルド:

docker build -t mcp/hubspot -f Dockerfile .

ライセンス

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

HubSpot MCP Server

Integrations