HubSpot MCP Server
HubSpot MCP サーバー
概要
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データ全体のセマンティック検索 |
パフォーマンス機能
ベクトルストレージ: 効率的なセマンティック検索と取得のために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:latestDockerの設定
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 toolshubspot_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
Scored across 16 tools
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.
All tools follow a consistent 'hubspot_verb_noun' pattern in snake_case, making the naming predictable and easy to follow.
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.
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
Related MCP Connectors
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Small business CRM: search and update contacts, companies, deals, sales pipeline, and tasks.
181
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with HubSpot CRM for managing contacts, companies, deals, and sending emails through natural language commands.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables management of HubSpot CRM entities including contacts, companies, deals, and pipelines through natural language. It provides comprehensive tools for listing, searching, creating, and updating records with support for OAuth 2.0 authentication.MIT
- AlicenseAqualityCmaintenanceExposes HubSpot CRM data and actions as tools for AI agents, enabling contact lookup, company search, contact creation, and activity logging via natural language.4MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to HubSpot CRM, providing tools to manage contacts, companies, deals, and more via natural language.MIT