HubSpot MCP

ハブスポットMCP

HubSpot API のモデル コンテキスト プロトコル (MCP)実装。CRM データにアクセスして管理するための標準化されたインターフェースを提供します。

特徴

• HubSpot CRM APIの完全なカバー
• すべての標準 CRM オブジェクト (会社、連絡先、取引など) のサポート
• CRM Associations v4による高度な関連付け管理
• プロパティ検証を備えた企業固有のエンドポイント
• 効率的なデータ管理のためのバッチ操作
• 高度な検索とフィルタリング機能
• Zodによる型安全なパラメータ検証

前提条件

APIキーをお持ちでない場合は、こちらの手順に従ってアクセストークンを取得してください。OAuthのサポートは、今後の機能強化として予定されています。

クライアント構成

MCPクライアントとサーバーの設定にはいくつかのオプションがあります。ホスト型/リモートサーバーの場合は、SmitheryのCLIとSmithery APIキーを使用してください。ローカルインストールの場合は、 npxを使用するか、ソースからビルドしてください。それぞれのオプションについては以下で説明します。

Smithery リモートサーバー (推奨)

MCP クライアントのconfig.jsonにリモート サーバーを追加するには、 Smithery CLIから次のコマンドを実行します。

プロンプトが表示されたら、 HUBSPOT_ACCESS_TOKENを入力します。

鍛冶屋SDK

独自のエージェント アプリケーションを開発している場合は、ここにある定型コードを使用できます。

NPX ローカルインストール

npxを使用してサーバーをローカルにインストールするには、MCP クライアントのconfig.jsonに以下を追加します。

ソースからビルド

1. リポジトリをダウンロードしてください:

2. パッケージをインストールします（クローンされたリポジトリ内）：

3. MCP クライアントのconfig.jsonに次のコードを追加します。

設定変数

サポートされているツール

コアCRMオブジェクト

基本的なオブジェクト操作

• crm_list_objects : オプションのフィルタリングとページ区切りを使用して CRM オブジェクトを一覧表示します
• crm_get_object : IDで単一のCRMオブジェクトを取得する
• crm_create_object : 新しい CRM オブジェクトを作成する
• crm_update_object : 既存の CRM オブジェクトを更新する
• crm_delete_object : CRM オブジェクトを削除する

検索とバッチ操作

• crm_search_objects : 高度なフィルターを使用して CRM オブジェクトを検索します
• crm_batch_create_objects : 1回のリクエストで複数のオブジェクトを作成する
• crm_batch_update_objects : 1回のリクエストで複数のオブジェクトを更新する
• crm_batch_delete_objects : 1回のリクエストで複数のオブジェクトを削除する

CRMレコード管理

企業

• 基本操作:
  • crm_create_company : 検証されたプロパティを持つ新しい会社を作成する
  • crm_update_company : 既存の会社を更新する
  • crm_get_company : IDで単一の会社を取得する
  • crm_search_companies : 特定のフィルターで企業を検索
• バッチ操作:
  • crm_batch_create_companies : 1回のリクエストで複数の会社を作成する
  • crm_batch_update_companies : 1回のリクエストで複数の会社を更新する
• 不動産管理:
  • crm_get_company_properties : 利用可能なすべての会社プロパティを取得します
  • crm_create_company_property : 新しい会社プロパティを作成する

連絡先

• 基本操作:
  • crm_create_contact : 検証されたプロパティを持つ新しい連絡先を作成する
  • crm_update_contact : 既存の連絡先の情報を更新する
  • crm_get_contact : IDで単一の連絡先を取得する
  • crm_search_contacts : 特定のフィルターを使用して連絡先を検索する
• バッチ操作:
  • crm_batch_create_contacts : 1回のリクエストで複数の連絡先を作成する
  • crm_batch_update_contacts : 1回のリクエストで複数の連絡先を更新する
• 不動産管理:
  • crm_get_contact_properties : 利用可能なすべての連絡先プロパティを取得します
  • crm_create_contact_property : 新しい連絡先プロパティを作成する

リード

• 基本操作:
  • crm_create_lead : 検証されたプロパティを持つ新しいリードを作成する
  • crm_update_lead : 既存のリードの情報を更新する
  • crm_get_lead : IDで単一のリード情報を取得する
  • crm_search_leads : 特定のフィルターを使用してリードを検索する
• バッチ操作:
  • crm_batch_create_leads : 1回のリクエストで複数のリードを作成する
  • crm_batch_update_leads : 1回のリクエストで複数のリード情報を更新する
• 不動産管理:
  • crm_get_lead_properties : 利用可能なすべてのリードプロパティを取得する
  • crm_create_lead_property : 新しいリードプロパティを作成する

エンゲージメント管理

エンゲージメントの詳細

• 基本操作:
  • engagement_details_get : 特定のエンゲージメントの詳細を取得する
  • engagement_details_create : 新しいエンゲージメントを作成する
  • engagement_details_update : 既存のエンゲージメントを更新する
  • engagement_details_delete : エンゲージメントを削除する
  • engagement_details_list : フィルタリングしたすべてのエンゲージメントを一覧表示します
  • engagement_details_get_associated : 関連付けられたエンゲージメントを取得する

通話

• 基本操作:
  • calls_create : 新しい通話記録を作成する
  • calls_get : 通話の詳細を取得する
  • calls_update : 通話記録を更新する
  • calls_archive : 通話をアーカイブする
  • calls_list : すべての通話を一覧表示する
  • calls_search : 通話を検索
• バッチ操作:
  • calls_batch_create : 複数の呼び出しを作成する
  • calls_batch_read : 複数の呼び出しを読み取る
  • calls_batch_update : 複数の呼び出しを更新する
  • calls_batch_archive : 複数の通話をアーカイブする

メール

• 基本操作:
  • emails_create : 新しいメールレコードを作成する
  • emails_get : メールの詳細を取得する
  • emails_update : メールを更新する
  • emails_archive : メールをアーカイブする
  • emails_list : すべてのメールを一覧表示する
  • emails_search : メールを検索
• バッチ操作:
  • emails_batch_create : 複数のメールを作成する
  • emails_batch_read : 複数のメールを読む
  • emails_batch_update : 複数のメールを更新する
  • emails_batch_archive : 複数のメールをアーカイブする

会議

• 基本操作:
  • meetings_create : 新しい会議を作成する
  • meetings_get : 会議の詳細を取得する
  • meetings_update : 会議を更新する
  • meetings_delete : 会議を削除する
  • meetings_list : すべての会議を一覧表示する
  • meetings_search : 会議を検索
• バッチ操作:
  • meetings_batch_create : 複数の会議を作成する
  • meetings_batch_update : 複数の会議を更新する
  • meetings_batch_archive : 複数の会議をアーカイブする

注記

• 基本操作:
  • notes_create : 新しいノートを作成する
  • notes_get : ノートの詳細を取得する
  • notes_update : メモを更新する
  • notes_archive : ノートをアーカイブする
  • notes_list : すべてのメモを一覧表示する
  • notes_search : ノートを検索
• バッチ操作:
  • notes_batch_create : 複数のノートを作成する
  • notes_batch_read : 複数のノートを読み取る
  • notes_batch_update : 複数のノートを更新する
  • notes_batch_archive : 複数のノートをアーカイブする

タスク

• 基本操作:
  • tasks_create : 新しいタスクを作成する
  • tasks_get : タスクの詳細を取得する
  • tasks_update : タスクを更新する
  • tasks_archive : タスクをアーカイブする
  • tasks_list : すべてのタスクを一覧表示する
  • tasks_search : タスクを検索
• バッチ操作:
  • tasks_batch_create : 複数のタスクを作成する
  • tasks_batch_read : 複数のタスクを読み取る
  • tasks_batch_update : 複数のタスクを更新する
  • tasks_batch_archive : 複数のタスクをアーカイブする

関連付けと関係

CRM アソシエーション v4

• 基本操作:
  • crm_list_association_types : 利用可能な関連付けの種類を一覧表示する
  • crm_get_associations : オブジェクト間のすべての関連付けを取得する
  • crm_create_association : 関連付けを作成する
  • crm_delete_association : 関連付けを削除する
• バッチ操作:
  • crm_batch_create_associations : 複数の関連付けを作成する
  • crm_batch_delete_associations : 複数の関連付けを削除する

コミュニケーションの設定

サブスクリプション管理

• 基本操作:
  • communications_get_preferences : 連絡先の設定を取得する
  • communications_update_preferences : 連絡先の設定を更新する
  • communications_unsubscribe_contact : グローバル登録解除
  • communications_subscribe_contact : グローバル購読
  • communications_get_subscription_definitions : サブスクリプション定義を取得する
• 一括操作:
  • communications_get_subscription_status : 複数の連絡先のステータスを取得する
  • communications_update_subscription_status : 複数の連絡先のステータスを更新する

製品

基本操作:

• products_create : 指定されたプロパティを持つ製品を作成し、ID を含むオブジェクトのコピーを返します。
• products_read : IDで識別されるオブジェクトを読み取る
• products_update : IDで識別されるオブジェクトの部分更新を実行します。読み取り専用プロパティや存在しないプロパティはエラーになります。プロパティの値は、空の文字列を渡すことでクリアできます。
• products_archive : ID で識別されるオブジェクトをごみ箱に移動します。
• products_list : 製品ページを読み取ります。properties propertiesパラメータを使用して、返される内容を制御します。after after 、最後に正常に読み取られたリソースのページングカーソルトークンであり、さらに結果を含むページングされたレスポンスのpaging.next.after JSONプロパティとして返されます。
• products_search : 製品を検索

バッチ操作:

• products_batch_create : 製品のバッチを作成する
• products_batch_read : 内部IDまたは一意のプロパティ値で製品を一括読み取りします。idProperty idPropertyでレコードを取得し、カスタム一意値プロパティでレコードを取得します。
• products_batch_update : 内部 ID またはidPropertyクエリ パラメータで指定された一意の値によって製品のバッチを更新します。
• products_batch_archive : IDごとに製品を一括アーカイブする

貢献

貢献は大歓迎です！問題、貢献、連絡先に関するガイドラインについては、 CONTRIBUTING.md をご覧ください。