home / mcp / hubspot mcp server

HubSpot MCP Server

custom mcp server for hubspot

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ajaystream-hubspot-mcp-custom": {
      "command": "npx",
      "args": [
        "-y",
        "@hubspot/mcp-server"
      ],
      "env": {
        "PRIVATE_APP_ACCESS_TOKEN": "<your-private-app-access-token>"
      }
    }
  }
}

HubSpot MCP Server exposes HubSpot actions and data through a Model Context Protocol (MCP) interface, enabling AI clients to interact with HubSpot data via a consistent, robot-friendly API. This makes it easier to build automated workflows, generate insights, and perform CRM operations from AI agents while keeping authentication and permissions under your control.

How to use

You can use the HubSpot MCP Server with MCP-enabled clients such as Claude Desktop or Cursor. Each client can start the MCP server locally and point it to HubSpot via a private app access token. Once configured, you can ask your AI agent to retrieve CRM data, create or update records, manage associations, and handle engagements through natural prompts.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

1) Install Node.js and npm from the official installer for your operating system.

2) Create a private app in HubSpot and copy the generated access token. Use read-only scopes to start, then adjust permissions as needed.

Available tools

hubspot-get-user-details

Authenticates the current HubSpot private app access token, providing user information, hub details, authorized scopes, and account information.

hubspot-list-objects

Retrieves a paginated list of CRM records for a specified object type.

hubspot-search-objects

Performs filtered searches across CRM records using complex criteria and property-based filtering.

hubspot-batch-create-objects

Creates multiple CRM records of the same object type in a single API call.

hubspot-batch-update-objects

Updates multiple existing CRM records with new property values in a single API call.

hubspot-batch-read-objects

Retrieves multiple CRM records by their IDs in a single batch operation.

hubspot-get-schemas

Retrieves available custom object schemas with their objectTypeId and definitions.

hubspot-list-properties

Retrieves the complete catalog of properties defined for any CRM object type.

hubspot-get-property

Retrieves detailed information about a specific property definition.

hubspot-create-property

Creates new custom properties for CRM object types.

hubspot-update-property

Updates settings for existing custom properties.

hubspot-batch-create-associations

Establishes multiple relationships between CRM records across different object types.

hubspot-list-associations

Retrieves existing relationships between a specific record and other associated records.

hubspot-get-association-definitions

Retrieves valid association types and labels between specific object types.

hubspot-create-engagement

Creates engagements (Notes or Tasks) associated with contacts, companies, deals, or tickets.

hubspot-get-engagement

Retrieves engagement details by ID.

hubspot-update-engagement

Updates an existing engagement with new information.

hubspot-list-workflows

Retrieves a paginated list of workflows.

hubspot-get-workflow

Retrieves detailed information about a specific workflow, including actions, enrollment criteria, and scheduling.

hubspot-generate-feedback-link

Generates a feedback link for reporting tool issues or providing feedback.

hubspot-get-link

Generates HubSpot UI URLs to directly access records in the HubSpot interface.