Name: HubSpot MCP
Author: shinzo-labs

LABSCO SUMMARY

Typed tools where the object matters, a generic layer for everything else.

The pairing is the design decision worth noticing. Companies, contacts and leads get their own create, update, search and property tools because their filters and validated properties genuinely differ; everything else runs through crm_list_objects, crm_get_object and their siblings with an objectType argument, so a custom object is reachable without waiting for somebody to add a dedicated tool. Batch variants sit almost everywhere, which is what makes a migration or a bulk correction practical rather than theoretical. The cost is the count: 112 tool definitions is a lot of surface to carry into a session that wanted to look up one contact.

What it is

A HubSpot CRM server with a typed tool set for the objects whose properties differ, a generic objectType layer underneath it, and the association, engagement, communication-preference and product surfaces around both.

What you get

Companies, contacts and leads each with create, update, get, object-specific search, batch create and batch update, plus reading and creating that object's property definitions
A generic layer taking an objectType argument, so any CRM object is reachable: list, get, create, update, archive, search, and batch create, read, update and archive
Associations: the available association types for a pair of object types, associations read between objects, and created or archived one at a time or in batches
Engagements as first-class objects — meetings, notes, tasks, calls and emails — each with create, get, update, archive, list, search, and batch variants
engagement_details, including a get_associated variant for pulling an engagement's related records
Communication preferences read and updated, subscription definitions and status, and a contact subscribed or unsubscribed
Products listed, read, created, updated, archived, searched and handled in batches

Requirements

A HubSpot access token in HUBSPOT_ACCESS_TOKEN.

Setup effort

One command plus a key — npx -y @smithery/cli install @shinzo-labs/hubspot-mcp, then supply credentials

See installation options

USE CASES

01

Turning a call you just had into CRM records

Find the contact by whatever you remember of them, log the call against that record, put the substance in a note, and leave the follow-up as a task with an owner and a due date.

crm_search_contactscalls_createnotes_createtasks_create

02

Loading a list of accounts someone sent you

Create the companies and their contacts in two batch calls rather than one request per row, then look up which association type joins the two object types before creating those links in a batch of their own.

crm_batch_create_companiescrm_batch_create_contactscrm_list_association_typescrm_batch_create_associations

03

Honouring an unsubscribe request

Read the portal's subscription definitions and the contact's current preferences before changing anything, then unsubscribe them from email with the legal basis recorded alongside the change.

communications_get_subscription_definitionscommunications_get_preferencescommunications_unsubscribe_contact

04

Getting a company's whole history before a renewal call

Find the company, walk its associations out to the contacts and deals attached to it, then pull every engagement recorded against it inside the window you care about instead of reading five separate lists.

crm_search_companiescrm_get_associationsengagement_details_get_associated

05

Adding a field the CRM does not have yet

Read the existing contact properties to check nothing already covers it, define the new property with its type, field type and group, then backfill values across the affected contacts in one batch.

crm_get_contact_propertiescrm_create_contact_propertycrm_batch_update_contacts

112 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`calls_archive`

Archive (delete) a call record

BEFORE YOU INSTALL

What to know first

Tools you get

112 tools when we connected. Most tools write, including crm_archive_object, which deletes, and communications_unsubscribe_contact, which changes a contact's global marketing consent. Your token's scopes decide how much of that the model can use.

Requires

npx on PATH
HUBSPOT_ACCESS_TOKEN in your environment

Where it runs

The documented client runs the server on your machine.

CONTEXT COST

Heavy Standing cost

Rated by the size of the 112 tool definitions that ride along on every turn, not by how many there are

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp

MCP Clients

Any MCP client — npx

ANY MCP CLIENT — NPX · JSON

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

HubSpot MCP

Typed tools where the object matters, a generic layer for everything else.

What it is

What you get

Requirements

Setup effort

Turning a call you just had into CRM records

Loading a list of accounts someone sent you

Honouring an unsubscribe request

Getting a company's whole history before a renewal call

Adding a field the CRM does not have yet

112 tools

calls_archive

calls_batch_archive

calls_batch_create

calls_batch_read

calls_batch_update

calls_create

calls_get

calls_list

calls_search

calls_update

communications_get_preferences

communications_get_subscription_definitions

communications_get_subscription_status

communications_subscribe_contact

communications_unsubscribe_contact

communications_update_preferences

communications_update_subscription_status

crm_archive_association

crm_archive_object

crm_batch_archive_associations

crm_batch_archive_objects

crm_batch_create_associations

crm_batch_create_companies

crm_batch_create_contacts

crm_batch_create_leads

crm_batch_create_objects

crm_batch_read_objects

crm_batch_update_companies

crm_batch_update_contacts

crm_batch_update_leads

crm_batch_update_objects

crm_create_association

crm_create_company

crm_create_company_property

crm_create_contact

crm_create_contact_property

crm_create_lead

crm_create_lead_property

crm_create_object

crm_get_associations

crm_get_company

crm_get_company_properties

crm_get_contact

crm_get_contact_properties

crm_get_lead

crm_get_lead_properties

crm_get_object

crm_list_association_types

crm_list_objects

crm_search_companies

crm_search_contacts

crm_search_leads

crm_search_objects

crm_update_company

crm_update_contact

crm_update_lead

crm_update_object

emails_archive

emails_batch_archive

emails_batch_create

emails_batch_read

emails_batch_update

emails_create

emails_get

emails_list

emails_search

emails_update

engagement_details_archive

`calls_archive`

`calls_batch_archive`

`calls_batch_create`

`calls_batch_read`

`calls_batch_update`

`calls_create`

`calls_get`

`calls_list`

`calls_search`

`calls_update`

`communications_get_preferences`

`communications_get_subscription_definitions`

`communications_get_subscription_status`

`communications_subscribe_contact`

`communications_unsubscribe_contact`

`communications_update_preferences`

`communications_update_subscription_status`

`crm_archive_association`

`crm_archive_object`

`crm_batch_archive_associations`

`crm_batch_archive_objects`

`crm_batch_create_associations`

`crm_batch_create_companies`

`crm_batch_create_contacts`

`crm_batch_create_leads`

`crm_batch_create_objects`

`crm_batch_read_objects`

`crm_batch_update_companies`

`crm_batch_update_contacts`

`crm_batch_update_leads`

`crm_batch_update_objects`

`crm_create_association`

`crm_create_company`

`crm_create_company_property`

`crm_create_contact`

`crm_create_contact_property`

`crm_create_lead`

`crm_create_lead_property`

`crm_create_object`

`crm_get_associations`

`crm_get_company`

`crm_get_company_properties`

`crm_get_contact`

`crm_get_contact_properties`

`crm_get_lead`

`crm_get_lead_properties`

`crm_get_object`

`crm_list_association_types`

`crm_list_objects`

`crm_search_companies`

`crm_search_contacts`

`crm_search_leads`

`crm_search_objects`

`crm_update_company`

`crm_update_contact`

`crm_update_lead`

`crm_update_object`

`emails_archive`

`emails_batch_archive`

`emails_batch_create`

`emails_batch_read`

`emails_batch_update`

`emails_create`

`emails_get`

`emails_list`

`emails_search`

`emails_update`

`engagement_details_archive`

`engagement_details_create`

`engagement_details_get`

`engagement_details_get_associated`

`engagement_details_list`

`engagement_details_update`

`meetings_archive`

`meetings_batch_archive`

`meetings_batch_create`

`meetings_batch_update`

`meetings_create`

`meetings_get`

`meetings_list`