Skip to main content
Glama
enesjakozh
scopiousdigital

HubSpot MCP Server

by scopiousdigital
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Remote

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 (配列): 結果に含めるプロパティのリスト

  • 返される値: 指定されたプロパティを持つ会社の詳細

営業分析ツール

  1. hubspot_get_sales_analytics

  • 特定の期間の集計された売上分析データを取得する

  • 必要な入力:

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

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

  • オプション入力:

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

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

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

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

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

  1. hubspot_get_deal_history

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

  • 必要な入力:

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

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

  1. hubspot_get_deal_notes

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

  • 必要な入力:

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

  • オプション入力:

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

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

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

  1. hubspot_get_engagements_by_deal

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

  • 必要な入力:

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

  • オプション入力:

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

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

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

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

  1. hubspot_get_sales_performance

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

  • 必要な入力:

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

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

  • オプション入力:

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

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

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

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

  1. hubspot_get_pipeline_analytics

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

  • 必要な入力:

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

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

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

  • オプション入力:

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

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

  1. hubspot_get_forecast_analytics

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

  • 必要な入力:

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

  • オプション入力:

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

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

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

Related MCP server: HubSpot MCP

設定

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/scopiousdigital/hubspot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server