Skip to main content
Glama
HubSpot MCP Server

HubSpot MCP Server

by baryhuang

HubSpot MCP サーバー

Dockerハブ ライセンス: MIT

概要

AIアシスタントがHubSpot CRMデータと連携できるようにするモデルコンテキストプロトコル(MCP)サーバー。このサーバーはAIモデルとHubSpotアカウントを連携させ、コンタクト、企業、エンゲージメントデータへの直接アクセスを提供します。組み込みのベクターストレージとキャッシュメカニズムにより、HubSpot APIの制限を克服し、応答時間を短縮します。

HubSpotの実装では、堅牢なエラー処理とAPIの安定性を備え、最も頻繁に利用され価値の高いHubSpot操作を優先的に実行します。各コンポーネントはAIとの連携に最適化されており、複雑で多段階のCRMワークフローにおいても信頼性の高いパフォーマンスを実現します。

Related MCP server: HubSpot MCP Server

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 (読み取り/書き込み)

  • 営業メールを読む

クイックスタート

# 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ライセンス

Available Tools

16 tools
hubspot_create_companyC

Create a new company in HubSpot

Inputs: name (required), properties.

hubspot_create_contactC

Create a new contact in HubSpot

Inputs: lastname (required), firstname (required), email, properties.

hubspot_create_propertyB

Create a new custom property in HubSpot

Inputs: name (required), type (required), label (required), fieldType (required), +4 more.

hubspot_get_active_companiesB

Get most recently active companies from HubSpot

Inputs: limit.

hubspot_get_active_contactsB

Get most recently active contacts from HubSpot

Inputs: limit.

hubspot_get_companyB

Get a specific company by ID from HubSpot

Inputs: company_id (required), properties.

hubspot_get_company_activityC

Get activity history for a specific company

Inputs: company_id (required).

hubspot_get_contactC

Get a specific contact by ID from HubSpot

Inputs: contact_id (required), properties.

hubspot_get_propertyB

Get details of a specific HubSpot property definition

Inputs: object_type (required), property_name (required).

hubspot_get_recent_conversationsB

Get recent conversation threads from HubSpot with their messages

Inputs: after, limit, refresh_cache.

hubspot_get_ticket_conversation_threadsB

Get conversation threads associated with a specific ticket

Inputs: ticket_id (required).

hubspot_get_ticketsC

Get tickets from HubSpot based on configurable selection criteria

Inputs: limit, criteria, max_retries, retry_delay.

hubspot_search_dataB

Search for similar data in stored HubSpot API responses

Inputs: query (required), limit.

hubspot_update_companyC

Update an existing company record in HubSpot

Inputs: company_id (required), properties (required).

hubspot_update_contactB

Update an existing contact record in HubSpot

Inputs: contact_id (required), properties (required).

hubspot_update_propertyB

Update a HubSpot property definition (e.g., add dropdown options)

Inputs: options (required), object_type (required), property_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct purposes (companies, contacts, properties, tickets, conversations), but 'hubspot_search_data' is vague and overlaps with the broader search concept, and 'get_active_companies' vs 'get_company' could cause confusion.

    Naming Consistency5/5

    All tools follow a consistent 'hubspot_verb_noun' pattern in snake_case, making the naming predictable and easy to follow.

    Tool Count4/5

    16 tools cover several CRM entities (companies, contacts, properties, tickets, conversations). The count is reasonable but slightly on the higher end for the breadth of operations provided.

    Completeness2/5

    While many core operations exist (create, get, update for companies/contacts/properties, get tickets), there are notable gaps: no delete operations, no ticket creation or update, no conversation creation, and missing ticket update.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers