HubSpot MCP Server

@NaorAIdeas

About HubSpot MCP Server

No overview available yet

#hubspot #ai-assistant #crm #hubspot-api #api

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@naoraideas/hubspot-mcp-server"
      ],
      "env": {
        "HUBSPOT_API_KEY": "your_hubspot_api_key_here"
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is HubSpot MCP Server?

A Model Context Protocol (MCP) server implementation that acts as a bridge between applications and HubSpot's API, providing a standardized interface for interacting with HubSpot's CRM and related services. It is designed for developers and AI integrations seeking to manage HubSpot data through natural language or programmatic commands.

How to use HubSpot MCP Server?

Install via npm (npm install @NaorAIdeas/hubspot-mcp-server), then run as a command-line tool with hubspot-mcp-server or configure it with Claude Desktop by adding a mcpServers entry in claude_desktop_config.json using npx and the HUBSPOT_API_KEY environment variable.

Key features of HubSpot MCP Server

Manage contacts (search, create, update)
Manage companies (create, update, filter)
Manage deals (create, update, track stages)
Work with custom objects and timelines
Create and manage associations between records
Natural language‑style tool invocation

Use cases of HubSpot MCP Server

Sales: create deals, associate contacts, schedule follow‑ups
Client onboarding: add contacts, link projects, set meetings
Project handover: update deal status, create support tickets, schedule training

FAQ from HubSpot MCP Server

What API credentials are required?

A HubSpot API key (Personal Access Token) created from a Private App with scopes including crm.objects.contacts.read/write, crm.objects.companies.read/write, crm.objects.deals.read/write, crm.objects.custom.read/write, crm.associations.read/write, and timeline.read/write.

What are the runtime requirements?

Node.js version 14 or higher and a HubSpot account with API key.

How does the server communicate?

The server uses stdio transport (Command Line Tool) and is designed to work with MCP‑compatible hosts like Claude Desktop.

Which HubSpot objects are supported?

Contacts, Companies, Deals, Custom Objects, Associations, and Timeline Events. The README provides example natural language commands for each.

What dependencies does it use?

@hubspot/api-client, @modelcontextprotocol/sdk, dotenv, and zod. Licensed under MIT.

Frequently asked questions

What API credentials are required?

A HubSpot API key (Personal Access Token) created from a Private App with scopes including `crm.objects.contacts.read/write`, `crm.objects.companies.read/write`, `crm.objects.deals.read/write`, `crm.objects.custom.read/write`, `crm.associations.read/write`, and `timeline.read/write`.

What are the runtime requirements?

Node.js version 14 or higher and a HubSpot account with API key.

How does the server communicate?

The server uses stdio transport (Command Line Tool) and is designed to work with MCP‑compatible hosts like Claude Desktop.

Which HubSpot objects are supported?

Contacts, Companies, Deals, Custom Objects, Associations, and Timeline Events. The README provides example natural language commands for each.

What dependencies does it use?

`@hubspot/api-client`, `@modelcontextprotocol/sdk`, `dotenv`, and `zod`. Licensed under MIT.

Comments

Basic information

More Data & Analytics MCP servers

Rankbits

rankbits

AI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer

ScrapeCheck

FieldmodeLLC

Verify scraped data against the live source page. Signed verdicts, $0.01 via x402.

Hologrow

Hologrow Inc

Hologrow is the e-commerce data layer for any AI

xverum mcp

Xverum-LLC

Find and enrich the right people from 750M professional profiles. Search by role, seniority, skills, industry, and location in plain English. Pull profiles with work history, education, and seniority, then see who's like

Jitsu

Jitsu is an open-source Customer Data Platform — an MIT-licensed alternative to Segment. This MCP server gives your AI assistant direct control over a Jitsu workspace, so you can run and debug data pipelines in conversat