hubspot-mcp-server

MCP.Pizza Chef: lkm1developer

The hubspot-mcp-server is a robust MCP server implementation designed to integrate HubSpot CRM with AI assistants. It enables real-time interaction with HubSpot data, including managing contacts, companies, and retrieving detailed engagement histories. This server facilitates comprehensive access to HubSpot's API, empowering AI workflows to automate CRM tasks and enhance data-driven decision-making.

Unmaintained · No commits in 17 months.

Use This MCP server To

Create and update contacts in HubSpot CRM via AI commands Retrieve detailed company activity and engagement timelines Access recent engagement data across HubSpot instances Manage company records and CRM data programmatically Automate CRM data retrieval for sales and marketing insights Integrate HubSpot CRM data into AI-powered workflows Generate reports from HubSpot engagement and contact data

README

HubSpot MCP Server

TypeScript HubSpot API MCP SDK License: MIT

A powerful Model Context Protocol (MCP) server implementation for seamless HubSpot CRM integration, enabling AI assistants to interact with your HubSpot data.

Overview

This MCP server provides a comprehensive set of tools for interacting with the HubSpot CRM API, allowing AI assistants to:

  • Create and manage contacts and companies in your HubSpot CRM
  • Retrieve detailed company activity history and engagement timelines
  • Access recent engagement data across your entire HubSpot instance
  • Get lists of recently active companies and contacts
  • Perform CRM operations without leaving your AI assistant interface

Why Use This MCP Server?

  • Seamless AI Integration: Connect your AI assistants directly to your HubSpot CRM data
  • Simplified CRM Operations: Perform common HubSpot tasks through natural language commands
  • Real-time Data Access: Get up-to-date information from your HubSpot instance
  • Secure Authentication: Uses HubSpot's secure API token authentication
  • Extensible Design: Easily add more HubSpot API capabilities as needed

Installation

# Clone the repository
git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

hubspot-mcp-server FAQ

How do I authenticate the hubspot-mcp-server with my HubSpot account?
You authenticate using HubSpot API keys or OAuth tokens configured in the server settings.
Can the hubspot-mcp-server handle bulk contact updates?
Yes, it supports batch operations for creating and updating multiple contacts efficiently.
Is the hubspot-mcp-server compatible with all HubSpot API v3 endpoints?
It supports a comprehensive subset focused on contacts, companies, and engagement data relevant for AI workflows.
How does the server ensure data security when accessing HubSpot CRM?
It uses secure API authentication methods and scopes access according to configured permissions.
Can I extend the hubspot-mcp-server to support custom HubSpot objects?
Yes, the server is built on a modular MCP SDK allowing extension for custom object support.
What LLM providers work best with this MCP server?
It is provider-agnostic and works well with OpenAI, Anthropic Claude, and Google Gemini models.
How do I deploy the hubspot-mcp-server in my environment?
The server is implemented in TypeScript and can be deployed on any Node.js environment with network access to HubSpot APIs.
Does the server provide real-time updates from HubSpot?
It primarily queries HubSpot API endpoints; real-time updates require additional webhook integration.