HubSpot MCP Server

HubSpot MCP Server

概要

AI アシスタントが HubSpot CRM データを利用できるようにする Model Context Protocol（MCP）サーバーです。このサーバーは AI モデルと HubSpot アカウントをつなぎ、コンタクト、企業、エンゲージメントデータに直接アクセスできるようにします。組み込みのベクトルストレージとキャッシュ機構により、HubSpot API の制限を補いながら応答時間を短縮します。

この実装では、頻繁に利用される価値の高い HubSpot の操作を優先し、堅牢なエラー処理と API の安定性を実現しています。各コンポーネントは AI に適したやり取りができるよう最適化されており、複雑な複数ステップの CRM ワークフローでも安定したパフォーマンスを発揮します。

MCP-HubSpot を選ぶ理由

• CRM への直接アクセス：仲介手順なしで、Claude などの AI アシスタントを HubSpot データに接続できます
• コンテキストの保持：FAISS によるベクトルストレージにより、過去のやり取りをセマンティック検索できます
• 設定不要：最小限のセットアップで簡単に Docker をデプロイできます

プロンプトの例

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

What's happening lately with my pipeline?

利用可能なツール

このサーバーは、HubSpot の管理とデータ取得に利用できるツールを提供します。

ツール	目的
hubspot_create_contact	重複を防止しながらコンタクトを作成します
hubspot_create_company	重複を防止しながら企業を作成します
hubspot_get_company_activity	特定の企業のアクティビティを取得します
hubspot_get_active_companies	最近アクティブだった企業を取得します
hubspot_get_active_contacts	最近アクティブだったコンタクトを取得します
hubspot_get_recent_conversations	メッセージを含む最近の会話スレッドを取得します
hubspot_search_data	以前に取得した HubSpot データをセマンティック検索します

パフォーマンス機能

• ベクトルストレージ：効率的なセマンティック検索と取得に FAISS を使用します
• スレッド単位のインデックス作成：会話スレッドを個別に保存し、正確に取得できるようにします
• 埋め込みのキャッシュ：自動キャッシュ機能を備えた SentenceTransformer を使用します
• 永続ストレージ：設定可能なストレージディレクトリにデータがセッション間で保持されます
• マルチプラットフォーム対応：さまざまなアーキテクチャ向けに最適化された Docker イメージを提供します

セットアップ

前提条件

次のスコープを持つ HubSpot アクセストークンが必要です。

• crm.objects.contacts（読み取り／書き込み）
• crm.objects.companies（読み取り／書き込み）
• sales-email-read

クイックスタート

# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# Or pull Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Docker の設定

Claude デスクトップで手動設定する場合：

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # Optional persistent storage
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Docker イメージのビルド

Docker イメージをローカルでビルドするには：

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

マルチプラットフォームビルドの場合：

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .

開発

pip install -e .

ライセンス

MIT ライセンス