HubSpot MCP

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

Features

Complete coverage of the HubSpot CRM API
Support for all standard CRM objects (companies, contacts, deals, etc.)
Advanced association management with CRM Associations v4
Company-specific endpoints with property validation
Batch operations for efficient data management
Advanced search and filtering capabilities
Type-safe parameter validation with Zod

Installation

If you don't have an API key, follow the steps here to obtain an access token.

NPX (Recommended)

Add the following to your claude_desktop_config.json:

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

Manual Download

Download the repo:

git clone https://github.com/shinzo-labs/hubspot-mcp.git

Install packages (inside cloned repo):

pnpm i

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": [
        "/path/to/hubspot-mcp/index.js"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Smithery

To install for Claude Desktop automatically via Smithery:

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

Supported Endpoints

CRM Object Operations

Basic Operations

crm_list_objects: List CRM objects with optional filtering and pagination
crm_get_object: Get a single CRM object by ID
crm_create_object: Create a new CRM object
crm_update_object: Update an existing CRM object
crm_delete_object: Delete a CRM object

Search and Batch Operations

crm_search_objects: Search CRM objects using advanced filters
crm_batch_create_objects: Create multiple objects in a single request
crm_batch_update_objects: Update multiple objects in a single request
crm_batch_delete_objects: Delete multiple objects in a single request

CRM Associations v4

Association Management

crm_list_association_types: List available association types between object types
crm_get_associations: Get all associations between objects
crm_create_association: Create an association between two objects
crm_delete_association: Delete an association between two objects

Batch Association Operations

crm_batch_create_associations: Create multiple associations in a single request
crm_batch_delete_associations: Delete multiple associations in a single request

Company Operations

Basic Company Operations

crm_create_company: Create a new company with validated properties
crm_update_company: Update an existing company
crm_get_company: Get a single company by ID
crm_search_companies: Search companies with specific filters

Batch Company Operations

crm_batch_create_companies: Create multiple companies in a single request
crm_batch_update_companies: Update multiple companies in a single request

Company Property Management

crm_get_company_properties: Get all available company properties
crm_create_company_property: Create a new company property

Contact Operations

Basic Contact Operations

crm_create_contact: Create a new contact with validated properties (email, name, phone, etc.)
crm_update_contact: Update an existing contact's information
crm_get_contact: Get a single contact by ID with optional properties and associations
crm_search_contacts: Search contacts with specific filters

Batch Contact Operations

crm_batch_create_contacts: Create multiple contacts in a single request
crm_batch_update_contacts: Update multiple contacts in a single request

Contact Property Management

crm_get_contact_properties: Get all available contact properties
crm_create_contact_property: Create a new contact property

Supported Object Types

Companies
Contacts
Deals
Tickets
Products
Line Items
Quotes
Custom Objects

Contributing

Contributions are welcomed and encouraged. Contact austin@shinzolabs.com with any questions, comments or concerns.

Integrations