ハブスポット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
に以下を追加します。
ソースからビルド
- リポジトリをダウンロードしてください:
- パッケージをインストールします(クローンされたリポジトリ内):
- MCP クライアントの
config.json
に次のコードを追加します。
設定変数
変数 | 説明 | 必須? | デフォルト |
---|---|---|---|
HUBSPOT_ACCESS_TOKEN | Hubspotアプリケーションのアクセストークン | はい | |
PORT | ストリーミング可能な HTTP トランスポート方式のポート | いいえ | 3000 |
サポートされているツール
コア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
: 製品ページを読み取ります。propertiesproperties
パラメータを使用して、返される内容を制御します。afterafter
、最後に正常に読み取られたリソースのページングカーソルトークンであり、さらに結果を含むページングされたレスポンスのpaging.next.after
JSONプロパティとして返されます。products_search
: 製品を検索
バッチ操作:
products_batch_create
: 製品のバッチを作成するproducts_batch_read
: 内部IDまたは一意のプロパティ値で製品を一括読み取りします。idPropertyidProperty
でレコードを取得し、カスタム一意値プロパティでレコードを取得します。products_batch_update
: 内部 ID またはidProperty
クエリ パラメータで指定された一意の値によって製品のバッチを更新します。products_batch_archive
: IDごとに製品を一括アーカイブする
貢献
貢献は大歓迎です!問題、貢献、連絡先に関するガイドラインについては、 CONTRIBUTING.md をご覧ください。
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management.Last updated -599PythonMIT License
- -securityAlicense-qualityA server that enables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management with multi-user token-based authentication.Last updated -PythonMIT License
- AsecurityAlicenseAqualityEnables AI models to interact with HubSpot CRM data and operations through a standardized interface while providing a centralized shared space for teams to share conversation summaries in real time.Last updated -8PythonMIT License
- -securityAlicense-qualityEnables Claude to interact with HubSpot CRM for sales analysis and insights, providing tools for managing contacts, deals, companies, and retrieving sales analytics data.Last updated -119JavaScriptMIT License