HubSpot MCP server for Claude, ChatGPT, Claude Code and Cursor

Creates a new hubspot contact.

Creates a new hubspot company.

Creates a new hubspot product.

Creates multiple hubspot tickets in a batch, each with its own properties and associations; `inputs` list must not be empty, each item needs `properties`, and associations/custom properties must be validly defined using internal names for custom fields and iso 8601 for dates.

Retrieves a reverse chronological list of all mutations (changes) for a specific pipeline stage; the associated pipeline id is inferred from the api path and is not a direct input.

Retrieves a paginated list of products from hubspot crm, optionally including specific properties, their history, associated object ids, and filtering by archived status.

Associates an existing asset ('form', 'object list', or 'external web url') with a specified hubspot marketing campaign.

Adds a new custom data token to an existing event template for a specified hubspot application, optionally populating a crm object property if objectpropertyname is provided.

Archives the hubspot email specified by `emailid` by moving it to the recycling bin, making it inaccessible unless restored.

Archives a batch of existing, non-archived quotes by their ids; this action is irreversible and useful for managing outdated or irrelevant quotes.

Archives a batch of companies by their unique ids; targeted companies must exist, not be previously archived, and this api operation is irreversible.

Archives a batch of existing contacts by their hubspot crm ids, rendering them inactive; this action is irreversible via the api and requires manual restoration or a separate unarchive endpoint.

Archives a batch of existing deals by their unique hubspot ids, removing them from active views and reports (soft delete); archived deals may be restorable.

Asynchronously archives a batch of hubspot feedback submissions using their unique ids, which must correspond to valid and existing submissions; the operation is queued, and submissions are moved from active views without being deleted.

Archives a batch of existing line items by their unique ids in hubspot crm; this operation is irreversible via the api.

Archives a batch of existing, non-archived crm objects of a specified `objecttype` by their ids, effectively hiding them from active use.

Archives a batch of properties by their internal names for a specified hubspot crm object type; this operation is idempotent and safe to retry.

Archives an existing company in hubspot crm by its `companyid`, moving it to a recycling bin from which it can be restored, rather than permanently deleting it.

Archives a contact in hubspot crm by its id, moving it to the recycling bin; this is generally irreversible via api and removes the contact from active use.

Archives a specific hubspot crm object by its type and id, moving it to the recycling bin; this action is irreversible via the api but objects can often be restored via the hubspot ui.

Archives multiple hubspot emails by their ids.

Archives an existing, non-archived feedback submission in hubspot crm by its id, moving it to the recycling bin (not permanently deleting it).

Archives a specific hubspot line item by its id, moving it to a recoverable state.

Archives a hubspot product by its id.

Archives multiple hubspot products by their ids.

Archives a specified crm property by its object type and name, moving it to the recycling bin; note that some default hubspot properties cannot be archived.

Archives a hubspot property group, making it inactive and hidden (not permanently deleted, allowing potential restoration) with immediate effect on its crm visibility and usability.

Archives a hubspot quote object by id to the recycling bin; this is api-irreversible and may need manual restoration.

Archives a hubspot ticket by its id.

Archives multiple hubspot tickets by their ids.

Retrieves a reverse chronological audit log of all changes for a specific, existing hubspot crm pipeline, which is identified by its `pipelineid` and a valid `objecttype` that supports pipelines (e.g., 'deals', 'tickets').

Batch-retrieves hubspot company records by their ids, allowing custom id properties, specific properties to fetch, and historical data.

Retrieves a batch of hubspot email objects by their internal ids or values of a specified unique property, allowing targeted property selection, including historical data.

Updates multiple existing hubspot quotes in a batch; each quote is identified by its object id or a custom unique property (via `idproperty`), and only writable properties are modified.

Cancels an active hubspot data import job using its `importid`; this action is irreversible, and any data already processed will remain.

Duplicates an existing hubspot marketing email, identified by its `id`, into a new draft; an optional `clonename` can be assigned to this new email copy.

Configures or updates settings for a hubspot app's calling extension, including its name, ui url, iframe dimensions, `isready` status, and `supportscustomobjects` flag, for the specified `appid`.

Creates multiple company records in hubspot crm in a single batch operation, processing up to 100 companies per request.

Creates a new a/b test variation for an existing hubspot email, using its `contentid`; this action only creates the variation, it does not start the a/b test or send emails.

Creates a new, empty property group for a specified crm object type in hubspot, requiring a unique group name for that object type; properties must be added separately.

Creates a new marketing email in hubspot, allowing comprehensive configuration of content, recipients, sender details, a/b testing, scheduling, web version, and other settings; the internal `name` for the email is required.

Creates the *definition* (schema) of a new association in hubspot, specifying how two crm object types relate (not an actual link between records); any provided `name` must be unique for the `fromobjecttypeid` and `toobjecttypeid` pair.

Creates up to 100 new contact records in hubspot crm, optionally associating them with existing crm objects; ensure associated object ids are valid.

Creates multiple deals in hubspot crm; ensure any associated object ids, deal stages, and pipeline ids specified are valid and exist within the hubspot account.

Creates a batch of feedback submissions in hubspot, ideal for bulk imports; all property names, `associationtypeid`s, and association `to id`s must reference existing entities in hubspot.

Creates multiple crm objects of a specified `objecttype` (e.g., contacts, companies, deals) in a single batch operation, where each object can have its own set of properties and associations.

Efficiently creates multiple crm properties in a single batch for a specified hubspot object type (e.g., 'contacts', 'companies', custom object id), ideal for schema setup or updates.

Creates multiple hubspot crm quotes in a batch, ideal for bulk operations; provide meaningful quote details in `inputs` as property requirements can vary, and inspect response for individual quote statuses as partial success is possible.

Creates a new hubspot campaign.

Creates multiple hubspot campaigns in a single batch operation.

Creates a new hubspot crm object (e.g., contact, company, custom object) with specified `properties` (using valid internal names) and `associations` (to existing objects via valid type ids).

Creates a new hubspot deal.

Creates a new hubspot email.

Creates multiple hubspot emails in a single batch operation.

Creates a new event template for a hubspot app, defining structure, custom properties (tokens), and appearance (markdown with handlebars) of custom timeline events for crm objects; this template must exist before logging corresponding events.

Creates a new hubspot feedback submission to record customer feedback (e.g., survey responses, support interactions), optionally associating it with crm objects.

Creates a new hubspot line item.

Creates multiple hubspot line items in a single batch operation.

Creates multiple immutable timeline events in a batch, ideal for bulk data imports or real-time synchronizations, using a valid event template; may update crm properties if the template is so configured.

Creates a new custom object schema in hubspot crm with unique naming for schema and properties, defined display/required/searchable properties within the 'properties' list, provided immutable labels, and correctly configured 'enumeration' type properties (options/referencedobjecttype).

Creates or updates the draft version of a marketing email identified by `emailid`; if no draft exists, a new one is created from the current live version to prepare changes or a/b tests before publishing.

Creates a new hubspot pipeline for a specified crm `objecttype` (e.g., 'deals', 'tickets'), requiring the pipeline `label` be unique for that `objecttype` and each stage `label` be unique within the pipeline.

Creates a new stage in a specified hubspot crm pipeline for a given object type, such as 'deals' or 'tickets'.

Creates multiple hubspot products in a single batch operation.

Creates a new custom property for a specified hubspot crm object type; ensure `groupname` refers to an existing property group for the `objecttype`.

Creates a new quote object in hubspot crm with specified properties and associations.

Creates a new hubspot ticket.

Creates an immutable custom timeline event on a crm object's record using a specified, existing event template (identified by `eventtemplateid`), optionally updating crm object properties if defined in the template; requires `email`, `utk`, or `objectid` for association.

Creates a new hubspot workflow to automate processes; ensure `enrollmentcriteria` and `actions` use properties relevant to the specified `objecttypeid`.

Archives a batch of up to 50 marketing campaigns, hiding them from active views rather than permanently deleting them.

Deletes an existing marketing email, either permanently (default) or by archiving if `archived` is `true`.

Permanently deletes the settings for a calling extension app, specified by its `appid`, rendering it unusable for all connected hubspot accounts; this operation is irreversible.

Permanently deletes a marketing campaign from hubspot using its `campaignguid`; returns a 204 no content status even if the campaign does not exist.

Irreversibly deletes a hubspot contact for gdpr compliance (identified via `objectid` and `idproperty`); an email `objectid` for a non-existent contact may be blocklisted.

Permanently deletes a hubspot pipeline and all its stages by `pipelineid` and `objecttype`; this is irreversible, so use validation flags to avoid errors if the pipeline is not empty.

Permanently deletes a specific pipeline stage for an `objecttype` (e.g., 'deals', 'tickets') that supports pipelines; this operation is irreversible, so ensure no active crm records are associated with the stage to prevent data issues.

Permanently deletes a hubspot custom object schema, specified by its `objecttype`, after all associated crm records have been deleted.

Permanently and irreversibly deletes a specific timeline event template, identified by its `eventtemplateid`, from the application `appid`.

Irreversibly deletes all settings for a video conferencing application identified by its `appid` in hubspot, removing its configuration and preventing it from functioning until reconfigured; existing meetings and historical data are unaffected.

Permanently deletes a hubspot workflow by its id; deleted workflows cannot be restored via the api and the id must exist.

Fetches hubspot contact ids for a specified `campaignguid` (must be a valid uuid of an existing campaign) and `contacttype`, supporting date filtering and pagination.

Fetches a paginated list of read-only error details for a specific hubspot crm import, requiring a valid `importid` for a processed import.

Fetches call recording settings for a specified, existing hubspot calling extension app.

Fetches a revenue attribution report for a specified, existing marketing campaign, optionally using a specific attribution model and date range; if both start and end dates are given, `enddate` must not be earlier than `startdate`.

Permanently deletes a contact and associated content for gdpr compliance; an email used for identification via `idproperty`='email' that is not found will be irreversibly blocklisted.

Retrieves a list of currently active import jobs in hubspot for monitoring ongoing data operations.

Retrieves aggregated statistics for marketing emails (e.g., send counts), grouped by specified time intervals within a defined time range.

Retrieves aggregated statistics for marketing emails, optionally within an iso8601 formatted time range, by email ids, or specific email properties.

Fetches a list of marketing emails from a hubspot account, with options for filtering, sorting, pagination, and including performance statistics.

Retrieves a list of workflow summaries (id, name, type, status) from hubspot, using the 'limit' parameter for pagination.

Retrieves a specific, previously saved revision of a marketing email using its unique email id and revision id.

Retrieves a hubspot campaign by its id.

Retrieves key attribution metrics for an existing marketing campaign, identified by its `campaignguid`, within an optional date range.

Retrieves multiple hubspot campaigns.

Retrieves the draft version of a marketing email by its `emailid`; if no draft exists, returns the published version.

Retrieves multiple hubspot emails by their ids.

Retrieves a comprehensive summary of a specific hubspot crm import record by its `importid`, including status, progress, updates, results, and errors; useful for monitoring and troubleshooting data imports.

Fetches a list of marketing emails from hubspot, supporting filtering by creation/update timestamps, pagination, and sorting.

Retrieves a hubspot product by its id.

Retrieves multiple hubspot products by their ids.