What it does
hubspot for agents over MCP. Set up a profile with the hubspot CLI first.
- Connects パソコンで動く
- Account or key No key needed
- Category マーケティング・SNS
一緒に使える
この種の作業を AI に教える Skill。これと一緒に使えます
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 4/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 16/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
WireCat hubspot をインストールして。https://mcp.popnx.com/i/wirecat-hubspot-cli.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月18日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server WireCat hubspot を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "hubspot-cli": { "command": "npx", "args": [ "-y", "@wirecat/hubspot-cli", "mcp", "serve", "--profiles", "all" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、WireCat hubspot のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "hubspot-cli": { "command": "npx", "args": [ "-y", "@wirecat/hubspot-cli", "mcp", "serve", "--profiles", "all" ] } } }Claude を終了してもう一度開く
試してみる
WireCat hubspot を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が WireCat hubspot を使っていると言うか、回答に WireCat hubspot のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ WireCat hubspot につなげません
WireCat hubspot はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · WireCat hubspot につなげるアプリを使う
- 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
B · マーケティング・SNS の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Google Ads + Meta Ads + SEO/GEO MCP✓ ChatGPT
- Cargo✓ ChatGPT
- NotFair✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server WireCat hubspot を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user hubspot-cli -- npx -y @wirecat/hubspot-cli mcp serve --profiles all 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、WireCat hubspot のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user hubspot-cli -- npx -y @wirecat/hubspot-cli mcp serve --profiles allClaude Code で /mcp と入力
WireCat hubspot が一覧にあり、接続済みと表示されれば OK です
試してみる
WireCat hubspot を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が WireCat hubspot を使っていると言うか、回答に WireCat hubspot のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server WireCat hubspot を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "hubspot-cli": { "command": "npx", "args": [ "-y", "@wirecat/hubspot-cli", "mcp", "serve", "--profiles", "all" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、WireCat hubspot のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
WireCat hubspot を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が WireCat hubspot を使っていると言うか、回答に WireCat hubspot のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server WireCat hubspot を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "hubspot-cli": { "type": "stdio", "command": "npx", "args": [ "-y", "@wirecat/hubspot-cli", "mcp", "serve", "--profiles", "all" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、WireCat hubspot のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
WireCat hubspot を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が WireCat hubspot を使っていると言うか、回答に WireCat hubspot のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user hubspot-cli -- npx -y @wirecat/hubspot-cli mcp serve --profiles allClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hubspot-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/hubspot-cli",
"mcp",
"serve",
"--profiles",
"all"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"hubspot-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/hubspot-cli",
"mcp",
"serve",
"--profiles",
"all"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"hubspot-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/hubspot-cli",
"mcp",
"serve",
"--profiles",
"all"
]
}
}
}この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
- 週あたりのダウンロードi
- npm/PyPIにない
- 確認済みドメイン
- ✓ wirecat.dev
- 接続方法
- パソコンで動く
- 最新バージョンi
- 0.2.0
- カテゴリi
- マーケティング・SNS
- レジストリ公開日i
- 2026年11月18日
- コードの最終更新i
- 2026年11月18日
- 作者
- WireCatLabs
- パッケージ
npm: @wirecat/hubspot-cli- ウェブサイト
- wirecat.dev
- レジストリでの状態
- 有効
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名はドメイン wirecat.dev で確認済みです(レジストリがドメインの所有を確認しています)
- ✓ 合格
今もメンテナンスされている
コードの最終更新:昨日
- ✓ 合格
ライセンスがある
Apache-2.0を使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に @wirecat/hubspot-cli@0.2.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月18日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/wirecat-hubspot-cli)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
マーケティング・SNSのほかのサーバーとの比較i
- このカテゴリのほかの4175件のうち86%よりスターが多い
- このカテゴリのほかの4175件のうち93%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの4175件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
WireCat hubspotは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は昨日、最新バージョン(0.2.0)がレジストリに届いたのは昨日です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| これ WireCat hubspot | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | はい | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| ライセンス | Apache-2.0 | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
hubspot: HubSpot CRM CLI for AI agents
Know where every deal stands and what changed overnight, without opening HubSpot. Ask your AI agent, and it answers from a copy of your deals, contacts and companies on your computer, even offline.
Docs · Install · Usage · Discord
- Ask instead of clicking. "Which deals are stuck in Contract sent?" gets an answer in a second, in Claude Code, Codex or any app that speaks MCP.
- The morning starts with what changed.
changes listshows what each sync saw change, and a schedule sends it to you. - Writes when you want them. Create and update deals, contacts and companies, move a deal or close it. The key stays read only until you give it the write scopes, and a delete asks first.
You: What changed in the CRM since yesterday?
Agent: (runs hubspot work changes list "at>=1d") · New deal "Example kitchen", 15 000 EUR, in Appointment scheduled · "Example office" moved to Closed won, 8 200 EUR You: Who is the contact on Example kitchen? Agent: (runs hubspot work deals show deal:12) Anna Example, anna@example.com, at Example LLC.
*Invented deals, illustrative output.*
Quick start
A super admin of the HubSpot account makes one key first: a service key (Development → Keys → Service keys) or the access token of a legacy private app. Give it these read scopes:
crm.objects.contacts.read crm.objects.companies.read crm.objects.deals.read
crm.objects.owners.read crm.schemas.contacts.read crm.schemas.companies.read crm.schemas.deals.read sales-email-read
To let hubspot change records too, add crm.objects.contacts.write, crm.objects.companies.write and crm.objects.deals.write. Leave them out and the key only reads.
Add crm.objects.leads.read on Sales Hub Professional or Enterprise to read leads, and tickets to read tickets through api. A scope you leave out fails only the commands that need it.
npm install -g @wirecat/hubspot-cli
hubspot skill install # the agent skill, for Claude Code, Codex and Gemini CLI hubspot work session start # paste the key when asked, it goes to the keyring hubspot work sync # copy your deals, contacts and companies hubspot work deals list status:open
work is a profile, a name you choose for this account. It is the first word of every command that uses the account. You need Node.js 22.16 or a later 22.x, or Node.js 24 or later. hubspot doctor shows what is set up and needs no network.
More: install and connect
What you can do
- Know the pipeline. Open deals with their stage, amount and owner, the board of each pipeline and how many deals stand in each stage.
- See what changed. Deals made, moved, won and lost, given another owner, and new activities, since any time you name.
- Find a client. Any contact or company in the account, read live, with its phones and e-mails.
- Follow the work on a deal. Notes, calls, e-mails, meetings and tasks, copied with the deals.
- Change a deal from the chat. Create a deal, rename it, move it to the next stage, close it won or lost, or add a contact or a company, and the copy takes the change at once.
- Reach past the copy. Every operation of HubSpot's CRM API is a command of its own: notes, tasks, tickets, associations and merges included.
- Search across your work. A deal turns up next to the chat where you agreed on it and the meeting where you discussed it, if you use the other WireCat tools.
For AI agents
Ask in plain words. The agent picks the commands.
*"Use hubspot. Which deals are waiting in Contract sent, and for how much?"*
*"Use hubspot. What changed in the CRM since yesterday?"*
- Claude Code, Codex, Gemini CLI, OpenClaw and other agents with a terminal run
hubspotthemselves.hubspot skill installteaches them how. - Claude Desktop, Cursor and other MCP apps connect to
hubspot work mcp serve.
hubspot work mcp add claude-code --allow-writes # or: codex
hubspot work mcp config # the entry for Claude Desktop, Cursor and others
--allow-writes confirms you saw that the server offers commands that change something: sync and schedules on this computer, and the writes to HubSpot, which only a key with write scopes can make. Text from the account reaches the agent marked as untrusted, so the agent reads it as data, never as instructions. The sign-in commands are not offered over MCP.
More: agents and MCP
Why hubspot
- A copy of your CRM on your computer.
synccopies your deals with their contacts and companies, and the next sync takes only the changes. Lists, the pipeline and search then answer with no request to HubSpot, also offline. - The key stays in the system keyring. It never appears in output, errors or run records, and no command takes it as an argument.
- A permission on every command. Each command and each operation of HubSpot's API has its own level, so you decide what an agent may read and change.
- Your CRM beside your other context. Deals sit in the same local store as your messages, notes and meetings from the other WireCat tools, and
search allfinds them together. - As many accounts as you need. Each HubSpot account is a profile you name in the command, and none is ever picked for you.
- Free and open source. Apache 2.0.
Main features
Deals and the pipeline
hubspot work deals list stage:"Contract sent" # from the copy, offline too
hubspot work deals show deal:12 # one deal with its stage, amount and the people on it hubspot work pipelines list # the deal pipelines and their stages hubspot work leads list # leads, on Sales Hub Professional or Enterprise hubspot work deals create --title "Example kitchen" --amount 15000 --currency EUR hubspot work deals move deal:12 "Contract sent" # the next stage of its pipeline hubspot work deals close deal:12 won
Contacts, companies and owners
hubspot work people list "Anna" # any contact in the account, read live
hubspot work organizations list "Example LLC" # any company, read live hubspot work users list # the account's owners hubspot work people create --name "Anna Example" --email anna@example.com hubspot work organizations update 4021 --phone "+34 600 000 000"
Activities and what changed
hubspot work activities list # notes, calls, e-mails, meetings and tasks
hubspot work changes list "at>=1d" # what changed in the last day
Activities are copied once you turn on the activities setting. activities list names the setting.
Any operation of the API
hubspot work api list # every operation, without calling HubSpot
hubspot work api deals-list --limit 5 # one of them hubspot work api notes-create --body-file note.json # a note on a deal: a write, which asks first
api offers every operation of HubSpot's CRM API version 2026-03, from its 15 specs, each with its own permission: reads, writes and deletes. Notes, tasks and tickets are written here.
With your other sources
hubspot work search all "Example LLC" # the deal beside your other WireCat data
More: use it · command reference
How it works
- A key, not a user. A service key or a private app token belongs to the account, not to a person.
hubspotcopies the whole account, andowner:menames nobody: filter byowner:fromusers list. - Polite to HubSpot.
hubspotsends at most 4 requests a second for each profile, under HubSpot's limits on every plan. When the account has spent its daily allowance, it says when the allowance comes back. - Made for scripts.
--jsonprints one JSON value, and every error has a code to branch on.
Sign-in and profiles
A profile is a name you choose for one HubSpot account, such as work. It is the first word of every command that uses the account, and none is ever assumed: a command without one stops and names the choices. WCHUBSPOT_PROFILE=work sets it for one shell session.
hubspot work session start asks for the key without showing it, or reads it from stdin. It checks the key against the account and keeps it in the system keyring. --credential-storage file keeps it in a private file instead. session status --check names the account the key reads, session end forgets the key on this computer, and session list lists the profiles. account remove --keep-data or --delete-data forgets a profile, keeping or deleting its copy of the CRM.
A second profile that signs in to the same HubSpot account is refused, so one copy is never synced twice.
Settings and permissions
Each profile has a permission level for every command and every API operation: allow, ask, readonly or deny. A command's key is its name, such as deals.list. An API operation's key is api. , such as api.deals-search, and api covers them all.
Changing a deal, contact or company with its command goes ahead; deleting one asks. Every write of api also checks its group's .write, such as deals.write, and every delete its .delete: both ask. A write that does what a command does checks that command's key too, so deals.update deny holds on both paths. A key belongs to the account, not to a person, so giving a record an owner checks crm.assign-others, which is deny until you allow it. A GDPR delete of a contact checks people.erase as well, so you can deny it alone.
hubspot work config set permissions.people deny # this profile reads no contacts
Over MCP nobody is there to answer, so ask lets the command run. Set a key to readonly or deny to stop an agent. hubspot work mcp serve --permission people.list=deny makes a key stricter for one server only, never looser. WCHUBSPOT_READ_ONLY=1 refuses every write.
More: settings and permissions
Limits
hubspotis tested against a fake account built from HubSpot's API reference, and each release is checked against a HubSpot test account.- A contact keeps one e-mail and two numbers (phone and mobile), and a company one number and no e-mail: a longer list is refused. Leads, notes, tasks and a deal's contacts and company are written through
api. - HubSpot takes no idempotency key: a write that ended in
outcome_unknownmay have happened. Check before repeating. - Tickets are read and written only through
api, not copied. - Leads need Sales Hub Professional or Enterprise.
- Before 1.0,