HubSpot MCP

HubSpot + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。HubSpot API 向けにコミュニティが開発した Claude Code Skill および MCP サーバーです。HubSpot Inc. とは提携関係になく、同社の承認や後援も受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されているコマンドはすべて実際の CLI にあります。}

HubSpot Sales Hub のすべての機能に加え、オフラインでのオブジェクト横断クエリ、プロパティ変更履歴レポート、他の HubSpot ツールにはないエージェントネイティブなデータレイヤーを備えています。すでにお使いの AI で利用できます - ChatGPT（Plus/Pro+。このコネクターが再公開されるまで一時停止中です。mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot - さらにリモート経由で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されています。コードは不要です。

エージェントで利用する

セキュリティに関する注意（このコネクターが再公開されるまで）。 HTTP モード（--transport http）は、localhost 上であっても実行しないでください。このビルドはトークンを確認しますが、修正リリースで導入されるリクエストサイズと時間の制限より前のものです。また、MCP ツールは認証情報を使って変更を加えることもできます。デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定している場合は、停止してください。修正版は近日公開予定です。

MSP オーナーが実際に使う 6 つのエージェント（セルフサービスで、現在利用できます）：

AI エージェント	HubSpot スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で hubspot-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に hubspot-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードが必要になりますが、コネクターが再公開されるまで一時停止中です。このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックにも対応

大規模なインストールベースがありますが、正直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリとは異なります。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再リリースされるまで一時停止中です。Copilot Studio では HTTP モードが必要ですが、このビルドではそのモードはトークンを確認するものの、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同じです。Gemini アプリはリモートで動作するため、ChatGPT と同じ一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、さらに MCP にも対応しています。詳しくは以下の各インストールセクションをご覧ください。MCP を介して Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの詳しい接続方法については、docs/which-agent.md をご覧ください。

複数のエージェントを使いますか？ 1 つのコマンドで、サポート対象の 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。続いて、CLI／MCP バイナリ用のスキルごとのインストーラーを実行してください）。詳しくは docs/which-agent.md をご覧ください。

60 秒でインストール

方法 A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに Servosity/msp-skills から HubSpot Skill と MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hubspot/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hubspot/install.ps1 | iex を実行してください。その後、README に従って認証し、hubspot-cli --help を実行して使い方を確認してください。

このプロンプトは、シェルを実行できる任意のエージェントで使えます。

方法 B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hubspot/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hubspot/install.sh)

インストーラーは、hubspot-cli（CLI）と hubspot-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を介して Skill を検出します。

確認：

hubspot-cli --version

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、またはその他の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md をご覧ください。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の方法を含め、エージェントごとにセクションがあります。Claude Desktop では Settings > Extensions パネルが最も簡単な方法です。JSON の編集を希望するユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/hubspot --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/hubspot --force

Hermes はネイティブで MCP に対応しているため、hubspot-mcp サーバーも直接利用できます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使えます）：

https://github.com/servosity/msp-skills/tree/main/skills/hubspot から hubspot skill をインストールしてください。このスキルでは、必要な CLI（hubspot-cli）を openclaw: フロントマターブロック経由でインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターによる接続設定はあらかじめ用意されており、OpenClaw のリリースと同時に有効になります。

認証する

CLI に必要な認証情報を設定します（HubSpot ポータルから取得してください）：

HUBSPOT_ACCESS_TOKEN=<value> hubspot-cli doctor

doctor は、データにアクセスするコマンドを実行する前に、認証情報が機能することを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSPからよく聞かれる質問	コマンド
今月、結果が「Scheduled」だったことのあるミーティングはどれですか？　後から No Show や Completed に変わったものも含めて教えてください。	hubspot-cli meetings status-report --status scheduled --month 2026-04
今日、誰に電話すればよいですか？（日次のナーチャリングリスト）	hubspot-cli nurture queue --owner me --top 20 --agent
休眠状態になっているコンタクトや取引はありますか？	hubspot-cli stale contacts --days 30 --owner me
現在のパイプラインの健全性はどうですか？（リスクにさらされている金額＋停滞期間が最も長い取引）	hubspot-cli pipeline-health default --idle-days 14
営業担当者の負荷が高すぎませんか？	hubspot-cli owner-load --pipeline default
この取引のオブジェクト横断タイムラインはどうなっていますか？（すべての通話＋メール＋ミーティング＋メモ＋タスク）	hubspot-cli engagements of deal:1234567 --since 90d
昨日以降、コンタクト、取引、エンゲージメント、会社で何が変わりましたか？	hubspot-cli since 24h

コマンドの完全なリファレンスはguide.mdをご覧ください。AI エージェントの運用規約（--agent、--dry-run、変更を行う前に確認すべき場合）については、AGENTS.mdをご覧ください。

何が違うのか

ほとんどの HubSpot 連携や MCP サーバーは、質問ごとにライブ API を呼び出す仕組みです。1 件のレコードを扱うなら問題ありません。しかし、「前四半期のある時点でステージ X だったすべての取引を、アクティブな全 200 アカウントから抽出し、ステージ確率と現在の営業担当者の負荷で重み付けしたリスク金額も含めて」といった質問をする規模になると、対応できません。標準の HubSpot 検索／フィルター API では、「ある時点でステージ X だった」という部分に物理的に回答できません。回答できるのはプロパティ履歴エンドポイントだけです。さらに、ライブ REST を使って取引、コンタクト、所有者、エンゲージメント、プロパティスナップショットを結合すると、AI がコンテキストを消費する 50 回もの API 呼び出しが必要になります。

このスキルは、HubSpot をローカルの SQLite ミラーに同期し、全文検索に加えてプロパティ履歴のスナップショットテーブルも作成します（propertiesWithHistory をクエリ可能な形式で取り込む唯一の HubSpot CLI／MCP です）。集計を伴う質問も、ローカル SQL の結合 1 回で回答できます。即座に、オフラインで処理でき、AI が生データではなく回答を確認できます。meetings status-report、pipeline-health、engagements of などの複合コマンドは、取引 × コンタクト × 所有者 × エンゲージメント × プロパティごとの履歴スナップショットを結合します。これは、ステートレスな API ラッパーでは実現できません。

解決する課題

**課題：**月次の顧客レポートです。MSP の顧客から「4 月に、こちらとのミーティングで Scheduled だったものはいくつありますか？」と聞かれても、レポートを作成する頃には、そのミーティングはすべて Completed または No Show に変わっています。HubSpot の UI では「過去に一度でも Scheduled だったか」を確認できず、標準の検索／フィルター API でも確認できません。プロパティ履歴エンドポイントなら確認できますが、クエリ可能な形式で公開している HubSpot CLI や MCP はありません。運用担当者から長年寄せられている要望についてはHubSpot Community の V3 プロパティ履歴に関するスレッドをご覧ください。また、ワークフローへの影響については、r/hubspotのプロパティ履歴の保持に関する議論をご覧ください。

このスキルでは、MSP のオーナーが 1 つの AI プロンプトから実行できる 5 つのコマンドで、この課題を解決します。

• hubspot-cli sync --resources hubspot-meetings-crm --with-history hs_meeting_outcome,hs_meeting_title,hubspot_owner_id - プロパティスナップショットを取得し、レポートに必要なデータを保存します
• hubspot-cli meetings status-report --status scheduled --month 2026-04 --csv - 顧客向けレポートを 1 つのコマンドで作成します
• hubspot-cli meetings ever-had --property hs_meeting_outcome --value Scheduled --from 2026-04-01 --to 2026-04-30 - 同じデータをその場でクエリします
• hubspot-cli pipeline-health default --idle-days 14 - QBR の残りの項目として、今期にリスクにさらされているものを確認します
• hubspot-cli engagements of deal:<id> --since 90d - 検討中の特定の取引について、すべてのアクティビティ履歴を確認します

詳しい説明については、pain-point.mdをご覧ください。

よくある質問

ChatGPT で動作しますか？

このビルドでは動作しません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）は、HTTPS 経由で リモート MCP サーバーにのみ接続します。つまり、HubSpot MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードではトークンは確認しますが、リクエストのサイズや時間の制限がまだないため、コネクターが再公開されるまでは実行したり、トンネルの背後に配置したりしないでください。その理由については、mcp-install.md のセキュリティに関する注意事項をご覧ください。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも動作しますか？

はい。どれも MCP に対応しています。ツールごとのインストールコマンドは、上記の表と docs/which-agent.md の詳細ガイドをご覧ください。

コードの書き方を知っている必要がありますか？

いいえ。推奨するインストール方法は、Claude Code または Codex に1文貼り付けるだけです。エージェントが SKILL.md を読み込んでインストールします。代替方法として、OS ごとの1行インストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。HubSpot の認証情報を一度入力するだけです。

HubSpot のデータは安全ですか？

データは お使いのマシン上 に保持されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントに見えるのは CLI が返す内容だけで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含められたり、MSP Skills によってどこかに送信されたりすることはありません。

HubSpot 独自の Agent CLI（2026年5月発表）とはどう違いますか？

HubSpot は2026-05-27に、独自の Agent CLI を発表しました。スケジュールされた GTM 自動化（CRUD、JSONL、安全対策を組み込んだ一括操作）向けの、ステートレスなライブ API CLI です。このスキルは ステートフルでオフラインファーストな補完ツール です。HubSpot の CLI にない機能、つまりローカル SQLite ミラー、全文検索、1つのコマンドでのオブジェクト横断結合、そしてプロパティ履歴を活用する機能（meetings ever-had、meetings status-report）を提供します。HubSpot の CLI では、これらの機能は公開されていません。重要な部分ではイディオムに互換性があるため（--filter の文法、JSONL の標準入力／標準出力、大量のレコードに対する contacts bulk-update のドライラン → ダイジェスト → 確認の手順）、HubSpot の CLI 用に作成したプロンプトの大部分を移行できます。

HubSpot API のレート制限に達しますか？

ローカルミラーの主な目的は、読み取りクエリで API にアクセスしないこと です。最初の sync（ページ分割され、レート制限を考慮します。--with-history は propertiesWithHistory をリクエストしますが、HubSpot の一括読み取り API ドキュメント によると、1回のリクエストで返されるレコード数に上限があるため、CLI はそれに応じてページ分割します）の後は、すべての集計レポートがローカルの SQLite に対して実行され、API 呼び出しはゼロです。同期も控えめに行われます。ページ分割は組み込み済みで、--resources と --since 7d で対象を絞り込めます。また、HubSpot によるスロットリングが発生した場合、CLI は黙って無視せず、同期警告イベントを出力します。

HubSpot パートナーになる必要や、特定のプランを契約する必要はありますか？

パートナーである必要はありません。必要なのは、HubSpot の Private App アクセストークン です（app.hubspot.com/private-apps から、どのポータルでも無料で作成できます）。対象とするオブジェクト（コンタクト、取引、ミーティングなど）の読み取りスコープを設定してください。プロパティ履歴の保持期間はプランによって異なります。HubSpot は Free／Starter では約90日間、有料プランではそれ以上の期間、履歴を保持します。CLI はレスポンスに含まれる内容を記録し、最初の --with-history 同期以降の履歴を蓄積します。

HubSpot の UI の代わりになりますか？

いいえ。HubSpot の UI は、1件ずつのレコード確認、取引の編集、パイプラインのドラッグ＆ドロップ操作、そして営業担当者が日々使う機能に優れています。このスキルは、UI では営業担当者や AI エージェントがすぐに答えられない 集計に関する質問 に対応します。「今週、200件の取引で何が変わったか」「今四半期にリスクがあるのは誰か」「4月に Scheduled だったすべてのミーティング（その後ステータスが変わったものも含む）」といった質問です。使う画面は異なりますが、データは同じです。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。お使いの AI エージェント（Claude、ChatGPT、Codex など）の料金のみが発生し、その料金は当社ではなく AI プロバイダーから請求されます。

安全性モデル

まず、実情を正直にお伝えします。デフォルトでは、書き込みは制限されていません。 --dry-run は任意で指定するグローバルフラグ（「送信せずにリクエストを表示」、デフォルトはオフ）です。エージェントが最初に --dry-run を指定しない限り、生の作成・更新・削除コマンドは初回実行時に即座に送信されます。組み込みの変更制限は contacts bulk-update にのみあり、100 行を超える場合にだけ作動します（それより少ない件数は、制限を回避する旨の警告が 1 行表示された後、即座に実行されます）。そのため、実質的な制御となるのは、設定するエージェントレベルのポリシーと、トークンに付与する権限範囲です。

Tier	Examples	Recommended agent policy
読み取り	すべてのレポート、集計、検索（stale、pipeline-health、nurture queue、deals top、engagements of、meetings history、meetings ever-had、meetings status-report、since、notes signals、owner-load、nurture-mine、history）	許可
書き込み（通常）	contacts bulk-update（ダイジェストと --confirm による制限がありますが、100 行を超える場合のみ。それより少ない件数は即座に送信されます）、crm post-…-batch-create/update/upsert（合計 88 個。これらの生の書き込みには --confirm フラグがなく、即座に送信されます）	エージェントに --dry-run を指定させてプレビューし、送信前にコマンドの内容を人間が確認して承認するよう求めます。少ない件数で組み込みの制限に頼らないでください。
認証情報／セキュリティ	（検出されたものはありません）	必ず人間を介して実行
破壊的操作	crm delete-…-archive、*-crm delete-…、hubspot-contacts-crm post-…-gdpr-delete（合計 24 個）	必ず人間を介して実行し、明示的な確認を行う
管理者	（検出されたものはありません）	オペレーター専用。エージェントには使用させない

最も強力な制御手段は、HubSpot の認証情報に付与する権限範囲です。CLI で実行できるのは、その認証情報で許可されている操作だけです。読み取り／レポートのワークフローでは、読み取り専用トークンを使用してください。制限を設定する方法を含む詳細は、governance.md をご覧ください。

ステータス

実稼働環境で検証済みです。メンテナーの Servosity が、自社の本番テナントで確認しています。毎週開催の Build Sessions では、ほかの MSP も実稼働で利用しています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月。40 以上のエージェントに対応）に準拠しています。MCP と互換性があり、Hermes を含む MCP 対応エージェントで利用できます。OpenClaw に対応済みです（frontmatter の設定は完了しており、OpenClaw のローンチを待っています）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-06-04。