---

name: hubspot-automation description: "通过Rube MCP使用Composio集成自动化HubSpot CRM操作（联系人、公司、交易、工单、属性）。" risk: critical source: community date_added: "2026-02-27"

通过Rube MCP实现HubSpot CRM自动化

通过Composio的HubSpot工具包自动化HubSpot CRM工作流，包括联系人/公司管理、交易管道跟踪、工单搜索和自定义属性创建。

前提条件

• 必须连接Rube MCP（RUBE_SEARCH_TOOLS可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 hubspot 建立活跃的HubSpot连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式

设置

获取Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为MCP服务器。无需API密钥——只需添加端点即可工作。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证Rube MCP可用
2. 使用工具包 hubspot 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接完成HubSpot OAuth
4. 在运行任何工作流前确认连接状态显示ACTIVE

核心工作流

1. 创建和管理联系人

何时使用：用户想在HubSpot CRM中创建新联系人或更新现有联系人

工具序列：

1. HUBSPOT_GET_ACCOUNT_INFO - 验证连接和权限（前提）
2. HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA - 搜索现有联系人以避免重复（前提）
3. HUBSPOT_READ_A_CRM_PROPERTY_BY_NAME - 检查属性元数据以获取约束值（可选）
4. HUBSPOT_CREATE_CONTACT - 创建单个联系人（必需）
5. HUBSPOT_CREATE_CONTACTS - 批量创建联系人，最多100个（替代）

关键参数：

• HUBSPOT_CREATE_CONTACT：properties 对象包含 email、firstname、lastname、phone、company
• HUBSPOT_CREATE_CONTACTS：inputs 数组包含 {properties} 对象，每批最多100个
• HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA：filterGroups 数组包含 {filters: [{propertyName, operator, value}]}，properties 数组为要返回的字段

注意事项：

• 每批最多100条记录；更大的导入需要分块
• 使用不正确的属性名或枚举值会返回400 'Property values were not valid'
• 创建前始终搜索以避免重复
• GET_ACCOUNT_INFO的认证错误意味着所有后续调用都会失败

2. 管理公司

何时使用：用户想创建、搜索或更新公司记录

工具序列：

1. HUBSPOT_SEARCH_COMPANIES - 搜索现有公司（前提）
2. HUBSPOT_CREATE_COMPANIES - 批量创建公司，最多100个（必需）
3. HUBSPOT_UPDATE_COMPANIES - 批量更新现有公司（替代）
4. HUBSPOT_GET_COMPANY - 获取单个公司详情（可选）
5. HUBSPOT_BATCH_READ_COMPANIES_BY_PROPERTIES - 按属性值批量读取公司（可选）

关键参数：

• HUBSPOT_CREATE_COMPANIES：inputs 数组包含 {properties} 对象，最多100个
• HUBSPOT_SEARCH_COMPANIES：filterGroups、properties、sorts、limit、after（分页游标）

注意事项：

• 每批最多100个；更大的集合需要分块
• 立即存储返回的ID用于下游操作
• 属性值必须匹配精确的内部名称，而非显示标签

3. 管理交易和管道

何时使用：用户想搜索交易、查看管道阶段或跟踪交易进度

工具序列：

1. HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE - 映射管道和阶段ID/名称（前提）
2. HUBSPOT_SEARCH_DEALS - 使用过滤器搜索交易（必需）
3. HUBSPOT_RETRIEVE_PIPELINE_STAGES - 获取单个管道的阶段详情（可选）
4. HUBSPOT_RETRIEVE_OWNERS - 获取所有者/代表详情（可选）
5. HUBSPOT_GET_DEAL - 获取单个交易详情（可选）
6. HUBSPOT_LIST_DEALS - 列出所有交易（无过滤器）（备选）

关键参数：

• HUBSPOT_SEARCH_DEALS：filterGroups 包含 pipeline、dealstage、createdate、closedate、hubspot_owner_id 的过滤器；properties、sorts、limit、after
• HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE：objectType 设为 'deals'

注意事项：

• 结果嵌套在 response.data.results 下；属性通常是字符串（金额、日期）
• 阶段ID可能是可读字符串或不透明数字ID；使用 label 字段显示
• 过滤器必须使用内部属性名（pipeline、dealstage、createdate），而非显示名称
• 通过 paging.next.after 分页直到不存在

4. 搜索和筛选工单

何时使用：用户想按状态、日期或条件查找支持工单

工具序列：

1. HUBSPOT_SEARCH_TICKETS - 使用filterGroups搜索（必需）
2. HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE - 发现可用属性名（备选）
3. HUBSPOT_GET_TICKET - 获取单个工单详情（可选）
4. HUBSPOT_GET_TICKETS - 按ID批量获取工单（可选）

关键参数：

• HUBSPOT_SEARCH_TICKETS：filterGroups、properties（仅返回请求的属性）、sorts、limit

注意事项：

• 工单属性名可能与UI标签不同
• 使用 READ_ALL_PROPERTIES 发现正确的属性名
• 状态值是内部ID，不是显示标签

5. 自定义属性管理

何时使用：用户需要创建自定义CRM属性或检查现有属性模式

工具序列：

1. HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE - 列出现有属性（前提）
2. HUBSPOT_READ_A_CRM_PROPERTY_BY_NAME - 获取特定属性详情（可选）
3. HUBSPOT_CREATE_A_CRM_PROPERTY - 创建新自定义属性（必需）

关键参数：

• objectType：contacts、companies、deals、tickets
• 创建属性：name、label、type、fieldType、groupName、options（用于枚举）

最佳实践

• 始终先搜索再创建以避免重复
• 批量操作时分块为100条记录
• 立即存储返回的ID
• 使用内部属性名而非显示标签
• 操作前验证连接状态