HubSpot MCP Server

Enables AI agents to create, read, update, and delete HubSpot contacts through standardized MCP tool calls that map directly to HubSpot's REST API endpoints. Implements request/response serialization for contact properties (email, phone, name, custom fields) with automatic field validation against HubSpot's schema. Handles batch operations and property transformations between MCP message format and HubSpot's property object model.

Provides MCP tools to manage company records in HubSpot, including creation, property updates, and relationship linking to contacts. Implements company-specific fields (industry, revenue, employee count, domain) and handles many-to-many relationships between companies and contacts. Supports company search by domain or name with fuzzy matching capabilities delegated to HubSpot's search API.

Exposes HubSpot's deal management capabilities through MCP tools, enabling agents to create deals, update deal stages, and track deal properties (amount, close date, owner, pipeline). Implements deal-stage state machines that enforce valid transitions between pipeline stages defined in HubSpot. Handles deal-to-contact and deal-to-company associations with automatic relationship creation.

Provides MCP tools for creating and managing support tickets in HubSpot's service hub, including ticket creation, status updates, priority assignment, and agent assignment. Implements ticket-to-contact associations and supports custom ticket properties. Handles ticket status workflows (new, in progress, waiting on customer, closed) with validation against HubSpot's ticket pipeline configuration.

Exposes HubSpot's email marketing capabilities through MCP tools, enabling agents to send marketing emails, track opens/clicks, and manage email templates. Implements email-to-contact associations and supports dynamic content insertion based on contact properties. Handles email send validation (recipient list, template selection, sender verification) before delegating to HubSpot's email service.

Provides MCP tools to query HubSpot's contact property schema, including property names, types, validation rules, and custom field definitions. Implements schema caching to reduce API calls and enables agents to validate contact data before submission. Supports property enumeration (dropdown options) and field-level constraints (required fields, field length limits).

Implements MCP tools for searching and filtering HubSpot objects (contacts, companies, deals) using HubSpot's native search API. Supports complex filter expressions (AND/OR logic, property comparisons, date ranges) and returns paginated results with sorting options. Handles search result ranking and relevance scoring delegated to HubSpot's search engine.

Implements the core MCP protocol layer that serializes/deserializes tool calls and responses between the MCP client and HubSpot API. Handles request validation, error mapping (HubSpot API errors to MCP-compatible error responses), and retry logic for transient failures. Implements request/response logging for debugging and monitoring.

Handles HubSpot API authentication through API key validation and scope checking. Implements secure credential storage and supports multiple authentication methods (API key, OAuth token). Validates API key scopes against required permissions for each MCP tool before execution.