HubSpot MCP Server (Official)注目

HubSpot MCP Server (Official) とは？

HubSpot MCP は、https://mcp.hubspot.com で提供される HubSpot 公式のリモート MCP サーバーです。AI アシスタントが自然言語で CRM レコード、アクティビティ、マーケティングコンテンツ、会話を読み取り、許可されている場合は更新できます。サインインには OAuth を使用します。

サーバーは HubSpot がホストしているため、ローカルでのインストールや実行は不要です。HubSpot は別途、HubSpot CLI でアプリや CMS コンテンツを構築するためのローカルの Developer MCP server も提供していますが、こちらは CRM データを照会しません。このページではリモートの HubSpot MCP サーバーを扱います。

HubSpot MCP Server (Official) の使い方

前提条件： HubSpot のユーザーアカウントと、OAuth + PKCE（S256）に対応した MCP クライアント。API キーは使用せず、アクセス権は OAuth フローで取得します。

方法 1：組み込みコネクタ（Claude アプリ）。 Claude（Web、デスクトップ、モバイル）で Settings > Connectors を開き、Browse をクリックして HubSpot を検索し、Connect をクリックします。HubSpot アカウントにサインインし、権限を選んで Connect app をクリックします。Anthropic の有料プラン（Pro、Max、Team、Enterprise）が必要です。Super Admin と App Marketplace Access 権限を持つユーザーは直接接続できますが、それ以外のユーザーは事前に Super Admin によるコネクタの承認が必要です。

方法 2：任意の MCP クライアント + 独自の MCP connector。

1. HubSpot で Development > MCP Connectors（https://app.hubspot.com/l/mcp-auth-apps/）を開き、Create MCP connector をクリックします。
2. 名前とクライアントが使う redirect URL を入力し、Create をクリックします。
3. connector の詳細ページで client ID と client secret をコピーします。
4. クライアントに https://mcp.hubspot.com、client ID と secret、一致する redirect URL を設定します。
5. OAuth フロー（アカウント選択、権限付与、承認）を完了し、アシスタントに get_user_details を実行させて接続を確認します。

Claude Code

このページに掲載されている簡易コマンド：

claude mcp add hubspot --transport http https://mcp.hubspot.com

クライアントが connector の認証情報を必要とする場合、Claude Code は事前設定済みの OAuth 認証情報に対応しています。connector に http://localhost:8080/callback を redirect URL として登録してから、次を実行します：

claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 \
  hubspot https://mcp.hubspot.com

--client-secret を付けると secret の入力を求められます。Claude Code で /mcp を実行してサインインします。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）にリモートサーバーを追加します：

{
  "mcpServers": {
    "hubspot": {
      "url": "https://mcp.hubspot.com"
    }
  }
}

VS Code

.vscode/mcp.json にサーバーを追加します：

{
  "servers": {
    "hubspot": {
      "type": "http",
      "url": "https://mcp.hubspot.com"
    }
  }
}

Cursor や VS Code で OAuth クライアント認証情報を求められた場合は、MCP connector の client ID、secret、一致する redirect URL を使用してください。

MCP Inspector でテストする場合は、Streamable HTTP トランスポートで https://mcp.hubspot.com/ を指定し、http://localhost:6274/oauth/callback/debug を connector の redirect URL に追加します。

HubSpot MCP Server (Official) の主な機能

• 公式かつホスト型： HubSpot が https://mcp.hubspot.com で運用し、Streamable HTTP トランスポートを使用。ローカルプロセスは不要です。
• OAuth + PKCE： HubSpot でサインインするため、設定ファイルにトークンを貼り付ける必要がありません。
• 幅広い CRM 読み取り： コンタクト、会社、取引、チケット、リード、ユーザー、予約、プロジェクト、サービス、カスタムオブジェクト、セグメントに加え、通話、メール、ミーティング、メモ、タスク。
• 許可された範囲での書き込み： CRM レコード、アクティビティ、パイプライン、カスタムプロパティ、静的セグメントの作成・編集。条件付きフィールドロジックとパイプラインステージの検証が適用されます。
• マーケティングとコンテンツ： キャンペーン、マーケティングメールの下書きと分析、ランディングページ、ウェブサイトページ、ブログ記事。
• 会話： ライブチャット、チームメール、WhatsApp、SMS、Facebook Messenger、カスタムチャネル（受信トレイの設定による）。
• 権限準拠： すべてのリクエストはインストールしたユーザーとして実行され、Super Admin がコネクタのデータ権限を管理します。

HubSpot MCP Server (Official) のツール

利用できるツールはサブスクリプション、権限、アカウント設定によって異なります：

• アカウントとスキーマ： get_user_details、get_organization_details、discover_hubspot_schema でユーザー、ポータル、オブジェクトモデルを特定します。
• CRM レコード： search_crm_objects（最大 5 つのフィルターグループ、各グループ 6 フィルター、1 ページ 200 件）、get_crm_objects（1 リクエスト最大 100 ID）、manage_crm_objects、manage_segment。
• データとプロパティ： 構造化クエリ用の query_crm_data（先に tool_guidance を呼び出す）、および search_properties、get_properties、manage_custom_properties、manage_custom_pipelines、search_owners。
• キャンペーンとマーケティング： read_campaign_data、manage_campaign_objects、get_campaign_attribution_reports、get_marketing_email_analytics、manage_marketing_email。
• コンテンツ： manage_landing_page、manage_website_page、manage_blog_post、render_asset、get_content_analytics_report。
• 会話とシグナル： search_conversations、get_conversation_channel_metadata、search_intent_signals。
• AEO： get_aeo_metrics、manage_aeo_prompts、manage_aeo_recommendations（Marketing Hub Professional または Enterprise が必要）。

manage_crm_objects や manage_blog_post など一部の書き込みツールは、データを変更する前にユーザーの確認を求めます。

HubSpot MCP Server (Official) のユースケース

• パイプラインのレビュー： 「金額が 5 万ドルを超え、過去 14 日間アクティビティのない未成約の取引をまとめて」
• 商談前のアカウント調査： 「Acme Corp の最新のメモ、メール、ミーティングを取得し、未解決のチケットを一覧にして」
• CRM のデータ整備： 「example.com のコンタクトのうち担当者がいないものを見つけて、私に割り当てて」
• 作業の記録： 「今日の Jane Doe との通話を記録し、来週火曜日のフォローアップタスクを作成して」
• マーケティング分析： 「先月のマーケティングメールの成果はどうだった？」

HubSpot MCP Server (Official) と代替ツールの比較

• HubSpot Developer MCP server（公式、ローカル）： HubSpot CLI 8.2.0 以上で hs mcp setup を実行してインストールし、Claude Code、Codex CLI、Cursor、Gemini CLI、VS Code、Windsurf に対応します。アプリや CMS アセットの構築用であり、CRM データの照会には使いません。
• コミュニティ製サーバー： mcp-hubspot（Docker、取得済みデータに対する FAISS ベースのセマンティック検索）と Shinzo Labs HubSpot MCP（npx または Smithery）は、OAuth ではなく HubSpot のアクセストークンで認証します。HubSpot によるメンテナンスではありません。

HubSpot MCP Server (Official) のトラブルシューティング

• OAuth の redirect エラー： クライアントが送信する redirect URL は、MCP connector に登録したいずれかの URL と完全に一致する必要があります。一覧の最初の redirect URL がデフォルトです。
• PKCE やトークンのエラー： PKCE は必須です。code_verifier は 43〜128 文字で、challenge には code_challenge_method=S256 を使用する必要があります。refresh token が期限切れまたは無効化された場合は、OAuth フローを最初からやり直してください。
• 新しいツールやデータが表示されない： スコープはインストール時に付与されます。HubSpot がツールを追加した場合や Super Admin が権限を変更した場合は、再インストールまたは再接続して新しいスコープを付与してください。
• アクティビティや会話のデータがない： アカウントで Sensitive Data が有効な場合、MCP サーバーはアクティビティと会話のデータをブロックします。