ハブスポットMCP

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

特徴

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

インストール

⚠️ 注意: このサーバーでは多数のエンドポイントが利用できるため、クライアントアプリケーションに公開されるエンドポイントの数を制限するために、 Heimdallをインストールして設定することをお勧めします。

API キーをお持ちでない場合は、こちらの手順に従ってアクセストークンを取得してください。

NPX（推奨）

MCP クライアントのconfig.json (Heimdall を使用している場合は~/.heimdall/config.json ) に次のコードを追加します。

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

マニュアルダウンロード

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

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

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

pnpm i

MCP クライアントのconfig.json (Heimdall を使用している場合は~/.heimdall/config.json ) に次のコードを追加します。

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

鍛冶屋

Smithery経由で Claude Desktop を自動的にインストールするには:

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

API操作

コア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 : 複数の連絡先のステータスを更新する

貢献

皆様からの貢献を歓迎いたします。ご質問、ご意見、ご不明な点がございましたら、 austin@shinzolabs.comまでお問い合わせください。

HubSpot MCP

Integrations