Hubspot

HubSpot API 用の Model Context Protocol（MCP） サーバー実装です。CRM データにアクセスして管理するための標準化されたインターフェースを提供します。

特長

• HubSpot CRM API を完全にカバー
• すべての標準 CRM オブジェクト（会社、コンタクト、取引など）に対応
• CRM Associations v4 による高度な関連付け管理
• プロパティ検証に対応した会社固有のエンドポイント
• 効率的なデータ管理のための一括操作
• 高度な検索およびフィルタリング機能
• Zod による型安全なパラメーター検証

前提条件

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

クライアントの設定

MCP クライアントでサーバーを設定する方法はいくつかあります。ホスト型／リモートサーバーを設定する場合は、Smithery API キーを使って Smithery の CLI を使用してください。ローカルにインストールする場合は、npx を使用するか、ソースからビルドしてください。各方法について以下で説明します。

Smithery リモートサーバー（推奨）

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

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

プロンプトが表示されたら、HUBSPOT_ACCESS_TOKEN を入力してください。

Smithery SDK

独自のエージェントアプリケーションを開発している場合は、こちらのボイラープレートコードを使用できます。

NPX によるローカルインストール

npx を使ってサーバーをローカルにインストールするには、次の内容を MCP クライアントの config.json に追加してください。

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

ソースからビルド

1. リポジトリをダウンロードします。

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

2. パッケージをインストールします（クローンしたリポジトリ内で実行）。

pnpm i

3. 次の内容を 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	Streamable HTTP トランスポート方式のポート	いいえ	3000
TELEMETRY_ENABLED	テレメトリーを有効にする	いいえ	true

対応ツール

CRM の主要オブジェクト

• crm_list_objects：フィルタリングとページネーションを任意で指定して、CRM オブジェクトの一覧を取得します
• crm_get_object：ID を指定して、単一の CRM オブジェクトを取得します
• crm_create_object：新しい CRM オブジェクトを作成します
• crm_update_object：既存の CRM オブジェクトを更新します
• crm_archive_object：CRM オブジェクトをアーカイブ（削除）します
• crm_search_objects：高度なフィルターを使用して、CRM オブジェクトを検索します
• crm_batch_create_objects：1 回のリクエストで複数のオブジェクトを作成します
• crm_batch_read_objects：1 回のリクエストで複数のオブジェクトを読み取ります
• crm_batch_update_objects：1 回のリクエストで複数のオブジェクトを更新します
• crm_batch_archive_objects：1 回のリクエストで複数のオブジェクトをアーカイブ（削除）します

企業

• 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_archive：エンゲージメントをアーカイブ（削除）します
• 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_archive: ミーティングをアーカイブ（削除）
• 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_list_association_types: 利用可能な関連付けタイプを一覧表示
• crm_get_associations: オブジェクト間のすべての関連付けを取得
• crm_create_association: 関連付けを作成
• crm_archive_association: 関連付けをアーカイブ（削除）
• crm_batch_create_associations: 複数の関連付けを作成
• crm_batch_archive_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クエリパラメーターで指定できます。結果がさらにあるページ付きレスポンスでは、正常に読み取られた最後のリソースのページングカーソルトークンafterが、JSONプロパティpaging.next.afterとして返されます。
• products_search: 製品を検索
• products_batch_create: 複数の製品を作成
• products_batch_read: 内部IDまたは一意のプロパティ値を指定して、複数の製品を読み取ります。カスタムの一意な値のプロパティでレコードを取得するには、idPropertyパラメーターを指定します。
• products_batch_update: 内部ID、またはidPropertyクエリパラメーターで指定した一意の値を使って、複数の製品を更新します。
• products_batch_archive: IDを指定して複数の製品をアーカイブ

貢献

貢献を歓迎します。ぜひご参加ください。課題、貢献方法、お問い合わせ先については、CONTRIBUTING.mdをお読みください。

データ収集とプライバシー

Shinzo Labsは、製品やサービスの改善に役立てるため、このサーバーから限定的な匿名テレメトリーを収集しています。このプロセスでは、個人を特定できる情報は収集されません。収集するデータの種類や、このテレメトリーをオプトアウトする方法については、プライバシーポリシーをご確認ください。

ライセンス

MIT