HubSpot MCP Server

HubSpot's MCP server is now available as a beta release. This enables AI clients to seamlessly take HubSpot actions and interact with your HubSpot data, opening up powerful new integration possibilities for our ecosystem. For more information and to provide feedback, visit https://developers.hubspot.com/mcp. You can also use the prompt Provide feedback for HubSpot MCP tools from your preferred client application!

What is MCP?

MCP (Model Context Protocol) is an emerging standard that allows AI models to interact with applications through a consistent interface. It acts as an abstraction layer over HTTP, letting AI agents access application functionality without needing to understand specific API protocols.

Terms and Conditions

The HubSpot MCP Server is in beta and subject to the Early Adopter Program terms.

Pre-requisites

Install node and npm

Visit this link to download Node and NPM.

Create a private app in HubSpot:

Go to Settings > Integrations > Private Apps
Click "Create private app"
Name your app and set required scopes
Click "Create app"
Copy the generated access token

Consider starting with read-only scopes

Using the MCP Server

Claude Desktop

Download Claude Desktop here.
Add the server configuration to your Claude Desktop config file (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json in macOS) and restart Claude Desktop:

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

Save the file and restart Claude. You should now be able to access all the tools!
Visit this page for more information and troubleshooting.

Cursor

Create a .cursor/mcp.json file in your project

mkdir -p .cursor && touch .cursor/mcp.json

Put the following configuration to the file.

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

Save the file and restart Cursor. You should now be able to access all the tools!
Visit this page for more information and troubleshooting.

Other MCP Clients

List of other popular MCP Clients are here.

Example Usage

Once set up, try these example prompts:

Get Insights from Your HubSpot Data

Get me the latest update about Acme Inc. from my HubSpot account.
Summarize all deals in the "Decision maker bought in" stage in my HubSpot pipeline with deal value > $1000.
Summarize the last five tickets created for Alex Smith in my HubSpot account.

Create and Update CRM Records

Update the address for John Smith in my HubSpot account.
Create a new contact "[email protected]" for Acme Inc. in my HubSpot account.

CRM Associations

List all associated contacts and their roles for Acme Inc. from my HubSpot account.
List associated contacts for Acme Inc. in my HubSpot account.
Associate John Smith with Acme Inc. as a company in my HubSpot account.

Add Engagements

Add a task to send a thank-you note to [email protected] in my HubSpot account.
Add a note for Acme Inc. in my HubSpot account.
List my overdue HubSpot tasks.
From my HubSpot account, find the number of contacts does <company-name> have?

Tools

This MCP server provides a set of tools for interacting with the HubSpot CRM API.

| Category | Tool Name | Description

@hubspot/mcp-server