HubSpot MCP Server

基本能力

产品定位

HubSpot MCP Server 是一个模型上下文协议服务器，提供对 HubSpot API 的访问。该服务器使 LLMs 能够与 HubSpot 的联系人、交易和互动数据进行交互。

核心功能

• 联系人工具：
• get_contact_by_id：通过 HubSpot ID 检索联系人（支持字符串和整数 ID）
• get_contact_by_email：通过电子邮件地址查找联系人

• search_contacts：根据属性条件搜索联系人

• 交易工具：

• get_deal_by_id：通过 HubSpot ID 检索交易
• get_contact_deals：获取与联系人关联的所有交易

• get_deal_contacts：获取与交易关联的所有联系人

• 互动工具：

• get_latest_marketing_campaign：获取最近营销活动的信息
• get_campaign_engagement：获取与特定活动互动的联系人
• get_page_visits：获取访问特定页面的联系人
• get_contact_analytics：获取特定联系人的分析数据
• get_scheduled_meetings：获取在特定时间段内安排的会议
• get_meeting_details：获取特定会议的详细信息

适用场景

• 与 HubSpot 联系人、交易和互动数据进行交互
• 获取和分析营销活动数据
• 管理会议和互动

工具列表

• 联系人工具：get_contact_by_id, get_contact_by_email, search_contacts
• 交易工具：get_deal_by_id, get_contact_deals, get_deal_contacts
• 互动工具：get_latest_marketing_campaign, get_campaign_engagement, get_page_visits, get_contact_analytics, get_scheduled_meetings, get_meeting_details

常见问题解答

• 如何调试：使用 MCP Inspector 进行调试，运行命令 npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run hubspot-mcp-server
• 如何发布：使用 uv publish 命令发布到 PyPI，需要设置 PyPI 凭据

使用教程

使用依赖

• 需要安装 uv 工具

安装教程

uv pip install hubspot-mcp-server

调试方式

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run hubspot-mcp-server

许可证

该项目遵循 MIT 开源许可条款。