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.
