HubSpot MCP Server

HubSpot MCP サーバー

HubSpot の API を操作するための標準インターフェースを提供する、HubSpot 用の Model Context Protocol（MCP）サーバー実装です。

概要

このパッケージは、アプリケーションと HubSpot の API をつなぐブリッジとして機能する MCP サーバーを実装しています。Model Context Protocol を通じて、HubSpot のサービスを操作する標準的な方法を提供します。

使用例

AI が HubSpot のワークフローをどのように変革できるか、気になりませんか？次の実例が、簡単な会話だけで実現する様子をご覧ください。

💡 営業とプロジェクト管理

「TechCorp の Sarah と、同社のクラウド移行プロジェクトについて素晴らしい打ち合わせをしました。25万ドルの新しい取引を作成して会社レコードに関連付け、来週、実施スケジュールについて話し合うため、同社の CTO とのフォローアップ通話を設定してください。」

🚀 クライアントのオンボーディング

「最大のクライアントである Enterprise Solutions がチームを拡大しています。新しい CTO の連絡先を作成して「Digital Transformation」プロジェクトに関連付け、今後2週間にわたって技術チームとの一連のオンボーディング会議を設定してください。」

⚡ プロジェクトの引き継ぎ

「「AI Integration」プロジェクトが最終段階に移行しています。取引のステータスを更新し、引き継ぎプロセス用の新しいサポートチケットを作成して、来月、クライアントチームとのトレーニングセッションを設定してください。その際、IT 部門の関連する連絡先をすべて含めてください。」

使用方法

コマンドラインツールとして実行する

サーバーは stdio で動作し、コマンドラインツールとして使用できます。

hubspot-mcp-server

Claude Desktop との統合

このサーバーを Claude Desktop で使用するには、次の設定を claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@naoraideas/hubspot-mcp-server"
      ],
      "env": {
        "HUBSPOT_API_KEY": "your_hubspot_api_key_here"
      }
    }
  }
}

インストール

npm install @NaorAIdeas/hubspot-mcp-server

前提条件

• Node.js（バージョン 14 以降）— 公式ウェブサイトからダウンロードしてインストールしてください
• HubSpot API キー（個人用アクセストークン）

設定

HubSpot API キーの取得

HubSpot MCP サーバーを使い始めるには、API キーを取得する必要があります。詳しい手順は次のとおりです。

1. HubSpot アカウントにログインする

   • HubSpot のウェブサイトにアクセスし、アカウントにサインインします

2. プライベートアプリに移動する

   • ［設定］>［アカウント設定］>［連携］>［プライベートアプリ］に移動します
   • この項目が表示されない場合は、必要な権限があることを確認してください

3. 新しいプライベートアプリを作成する

   • ［プライベートアプリを作成］をクリックします
   • アプリに分かりやすい名前を付けます（例：「HubSpot MCP Server」）
   • アプリの用途を説明する説明を追加します

4. スコープを設定する

   • 次のスコープを選択します（最低限必要なもの）。
     • crm.objects.contacts.read
     • crm.objects.contacts.write
     • crm.objects.companies.read
     • crm.objects.companies.write
     • crm.objects.deals.read
     • crm.objects.deals.write
     • crm.objects.custom.read
     • crm.objects.custom.write
     • crm.associations.read
     • crm.associations.write
     • timeline.read
     • timeline.write

5. 保存して API キーを取得する

   • ［アプリを作成］をクリックします
   • 生成されたアクセストークンをすぐにコピーします
   • トークンは一度しか表示されないため、安全に保管してください

利用可能なツール

連絡先の管理

• 「(415) 555-0123 から電話がありました。この人は誰ですか？」
• 「Acme Corp の John Smith の役職を営業担当副社長に更新してください」
• 「TechStart Inc の Emma Wilson のメールアドレスを教えてください」

会社の管理

• 「サンフランシスコ地域の会社をすべて表示してください」
• 「IT 分野の「CloudTech Solutions」の新しい会社レコードを作成してください」
• 「Microsoft の年間売上高を2,000億ドルに更新してください」

取引の管理

• 「「Enterprise Cloud Migration」の取引の状況はどうなっていますか？」
• 「15万ドル相当の「AI Integration Project」の新しい取引を作成してください」
• 「「Digital Transformation」の取引を「契約書送付済み」ステージに移動してください」

カスタムオブジェクト

• 「『Product Development』パイプライン内のすべてのアクティブなプロジェクトを表示して」
• 「『Server Downtime』の問題について、新しいサポートチケットを作成して」
• 「『Mobile App Launch』プロジェクトの優先度を「High」に更新して」

関連付け

• 「『Enterprise Solutions』企業に関連付けられている連絡先を教えて」
• 「Sarah Johnson を『Cloud Migration』プロジェクトに関連付けて」
• 「Mark Davis と『Legacy System』プロジェクトの関連付けを解除して」

タイムラインイベント

• 「今月、Google との予定が入っているすべての会議を表示して」
• 「来週の火曜日に、Amazon との新しいフォローアップコールを作成して」
• 「昨日の Microsoft との製品デモの説明を更新して」

開発

環境のセットアップ

プロジェクトのルートに次の内容を含む .env ファイルを作成します。

HUBSPOT_API_KEY=your_hubspot_api_key_here

プロジェクトのビルド

npm run build

開発モード

ウォッチモードでプロジェクトを実行するには、次のようにします。

npm run watch

依存関係

• @hubspot/api-client：HubSpot API クライアント
• @modelcontextprotocol/sdk：Model Context Protocol SDK
• dotenv：環境変数の管理
• zod：スキーマの検証

ライセンス

このプロジェクトは、MIT License のもとでライセンスされています。

免責事項

本ソフトウェアは「現状有姿」で提供され、明示的または黙示的を問わず、商品性、特定目的への適合性、および非侵害性の保証を含みますが、これらに限定されない、いかなる保証もありません。いかなる場合においても、作者または著作権者は、本ソフトウェアもしくは本ソフトウェアの使用に起因または関連する、契約、不法行為、その他を問わない、いかなる請求、損害、その他の責任についても責任を負いません。

作者

Naor Hemed
AI 統合エキスパート＆ソフトウェアエンジニア
ビジネスワークフローを変革するインテリジェントシステムの構築に情熱を注いでいます。
ぜひつながり、AI が HubSpot の活用をどのように革新できるか、一緒に考えましょう！

GitHub | LinkedIn | Email

コントリビューション

このプロジェクトは、HubSpot を AI を通じてより使いやすくしたいという情熱と ❤️ を込めて開発されました。
コントリビューションをご希望の場合や、ご質問がある場合、あるいは AI を活用したワークフローについて気軽に話したい場合は、お気軽にご連絡ください！