ハブスポットMCP

npmバージョン鍛冶屋のバッジ

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から次のコマンドを実行します。

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp

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

鍛冶屋SDK

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

NPX ローカルインストール

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

{ "mcpServers": { "hubspot": { "command": "npx", "args": [ "@shinzolabs/hubspot-mcp" ], "env": { "HUBSPOT_ACCESS_TOKEN": "your-access-token-here" } } } }

ソースからビルド

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

git clone https://github.com/shinzo-labs/hubspot-mcp.git

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

pnpm i

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

{ "mcpServers": { "hubspot": { "command": "node", "args": [ "/path/to/hubspot-mcp/index.js" ], "env": { "HUBSPOT_ACCESS_TOKEN": "your-access-token-here" } } } }

設定変数

変数	説明	必須？	デフォルト
`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 : 複数のタスクをアーカイブする

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

サブスクリプション管理

基本操作:
- 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 をご覧ください。

HubSpot MCP