HubSpot MCP Server

Exposes HubSpot contact CRUD operations through MCP tool schema, enabling AI agents to create, read, update, and delete contacts with property mapping to HubSpot's contact object model. Implements bidirectional sync between agent state and HubSpot's contact database through standardized MCP tool definitions that translate agent requests into HubSpot API calls with automatic property validation and error handling.

Provides MCP tools to navigate HubSpot's company object graph, including parent-child relationships, associated contacts, and deal pipelines. Implements hierarchical queries that allow agents to understand organizational structure and relationships without requiring multiple sequential API calls, using HubSpot's association API under the hood to resolve company-to-contact and company-to-deal relationships.

Exposes deal CRUD operations and pipeline stage transitions through MCP tools, enabling agents to move deals through sales pipelines, update deal properties (amount, close date, probability), and retrieve pipeline analytics. Implements validation of stage transitions based on HubSpot's pipeline configuration, preventing invalid state changes and maintaining data integrity across the sales process.

Provides MCP tools for creating, updating, and retrieving support tickets with status tracking, priority assignment, and assignment to support agents. Implements ticket lifecycle management including status transitions (new → open → waiting on customer → resolved → closed) and integrates with HubSpot's service hub to track customer support interactions and SLA compliance.

Exposes HubSpot's marketing email and workflow automation capabilities through MCP tools, enabling agents to trigger email sequences, enroll contacts in workflows, and retrieve campaign performance metrics. Implements workflow state management and email personalization by integrating with HubSpot's contact property system to dynamically populate email variables and conditional logic.

Provides MCP tools to query HubSpot's contact property schema, including property names, types, validation rules, and custom properties. Enables agents to dynamically discover available properties and validate property values before attempting updates, preventing API errors from invalid property assignments and enabling self-correcting agent behavior.

Provides MCP tools for batch operations on contacts and companies (create, update, delete multiple records in single requests), with granular error handling that reports per-record success/failure. Implements request batching to respect HubSpot API rate limits while maximizing throughput, and provides detailed error messages for failed records to enable agent retry logic.

Provides MCP tools to retrieve contact activity history including emails sent/received, meetings, calls, form submissions, and website visits. Implements timeline aggregation across multiple HubSpot modules (email, meetings, forms, tracking) to provide agents with a unified view of customer engagement without requiring separate API calls per activity type.

Provides MCP tools to manage contact list membership, including adding/removing contacts from static lists and querying list membership. Implements list-based segmentation that allows agents to organize contacts by criteria and trigger list-based workflows, integrating with HubSpot's list system for audience management and campaign targeting.

Implements MCP server protocol to expose HubSpot capabilities as standardized MCP tools with JSON schema definitions, enabling MCP clients (Claude Desktop, Cline, etc.) to discover and invoke HubSpot operations. Uses MCP's tool registry pattern to dynamically expose HubSpot API operations as callable tools with input/output schemas, enabling seamless integration with AI agents that support the MCP protocol.