hubspot-mcp MCP Server

A Model Context Protocol (MCP) server implementation for the HubSpot API, providing a standardized interface for accessing and managing CRM data.

Local serverstdioMIT

What is the hubspot-mcp Server?

hubspot-mcp is an MCP project maintained in the shinzo-labs/hubspot-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server implementation for the HubSpot API, providing a standardized interface for accessing and managing CRM data”. Read the project documentation for the complete scope.

Installation

The documented npm package is @shinzolabs/hubspot-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HUBSPOT_ACCESS_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
crm_list_objectsList CRM objects with optional filtering and pagination
crm_get_objectGet a single CRM object by ID
crm_create_objectCreate a new CRM object
crm_update_objectUpdate an existing CRM object
crm_archive_objectArchive (delete) a CRM object
crm_search_objectsSearch CRM objects using advanced filters
crm_batch_create_objectsCreate multiple objects in a single request
crm_batch_read_objectsRead multipl objects in a single request
crm_batch_update_objectsUpdate multiple objects in a single request
crm_batch_archive_objectsArchive (delete) multiple objects in a single request
crm_create_companyCreate a new company with validated properties
crm_update_companyUpdate an existing company
crm_get_companyGet a single company by ID
crm_search_companiesSearch companies with specific filters
crm_batch_create_companiesCreate multiple companies in a single request
crm_batch_update_companiesUpdate multiple companies in a single request
crm_get_company_propertiesGet all available company properties
crm_create_company_propertyCreate a new company property
crm_create_contactCreate a new contact with validated properties
crm_update_contactUpdate an existing contact's information
crm_get_contactGet a single contact by ID
crm_search_contactsSearch contacts with specific filters
crm_batch_create_contactsCreate multiple contacts in a single request
crm_batch_update_contactsUpdate multiple contacts in a single request
crm_get_contact_propertiesGet all available contact properties
crm_create_contact_propertyCreate a new contact property
crm_create_leadCreate a new lead with validated properties
crm_update_leadUpdate an existing lead's information
crm_get_leadGet a single lead by ID
crm_search_leadsSearch leads with specific filters
crm_batch_create_leadsCreate multiple leads in a single request
crm_batch_update_leadsUpdate multiple leads in a single request
crm_get_lead_propertiesGet all available lead properties
crm_create_lead_propertyCreate a new lead property
engagement_details_getGet details of a specific engagement
engagement_details_createCreate a new engagement
engagement_details_updateUpdate an existing engagement
engagement_details_archiveArchive (delete) an engagement
engagement_details_listList all engagements with filtering
engagement_details_get_associatedGet associated engagements
calls_createCreate a new call record
calls_getGet call details
calls_updateUpdate a call record
calls_archiveArchive a call
calls_listList all calls
calls_searchSearch calls
calls_batch_createCreate multiple calls
calls_batch_readRead multiple calls
calls_batch_updateUpdate multiple calls
calls_batch_archiveArchive multiple calls
emails_createCreate a new email record
emails_getGet email details
emails_updateUpdate an email
emails_archiveArchive an email
emails_listList all emails
emails_searchSearch emails
emails_batch_createCreate multiple emails
emails_batch_readRead multiple emails
emails_batch_updateUpdate multiple emails
emails_batch_archiveArchive multiple emails
meetings_createCreate a new meeting
meetings_getGet meeting details
meetings_updateUpdate a meeting
meetings_archiveArchive (delete) a meeting
meetings_listList all meetings
meetings_searchSearch meetings
meetings_batch_createCreate multiple meetings
meetings_batch_updateUpdate multiple meetings
meetings_batch_archiveArchive multiple meetings
notes_createCreate a new note
notes_getGet note details
notes_updateUpdate a note
notes_archiveArchive a note
notes_listList all notes
notes_searchSearch notes
notes_batch_createCreate multiple notes
notes_batch_readRead multiple notes
notes_batch_updateUpdate multiple notes
notes_batch_archiveArchive multiple notes
tasks_createCreate a new task
tasks_getGet task details
tasks_updateUpdate a task
tasks_archiveArchive a task
tasks_listList all tasks
tasks_searchSearch tasks
tasks_batch_createCreate multiple tasks
tasks_batch_readRead multiple tasks
tasks_batch_updateUpdate multiple tasks
tasks_batch_archiveArchive multiple tasks
crm_list_association_typesList available association types
crm_get_associationsGet all associations between objects
crm_create_associationCreate an association
crm_archive_associationArchive (delete) an association
crm_batch_create_associationsCreate multiple associations
crm_batch_archive_associationsArchive (delete) multiple associations
communications_get_preferencesGet contact preferences
communications_update_preferencesUpdate contact preferences
communications_unsubscribe_contactGlobal unsubscribe
communications_subscribe_contactGlobal subscribe
communications_get_subscription_definitionsGet subscription definitions
communications_get_subscription_statusGet status for multiple contacts
communications_update_subscription_statusUpdate status for multiple contacts
products_createCreate a product with the given properties and return a copy of the object, including the ID.
products_readRead an Object identified by ID
products_updatePerform a partial update of an Object identified by ID. Read-only and non-existent properties will result in an error. Properties values can be cleared by…
products_archiveMove an Object identified by ID to the recycling bin.
products_listRead a page of products. Control what is returned via the properties query param. after is the paging cursor token of the last successfully read resource…
products_searchSearch products
products_batch_createCreate a batch of products
products_batch_readRead a batch of products by internal ID, or unique property values. Retrieve records by the idProperty parameter to retrieve records by a custom unique value…
products_batch_updateUpdate a batch of products by internal ID, or unique values specified by the idProperty query param.
products_batch_archiveArchive a batch of products by ID

How to install the hubspot-mcp Server

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "@shinzolabs/hubspot-mcp"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HUBSPOT_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation