Hubspot MCP Server

A powerful HubSpot CRM integrated MCP server that provides tools for AI assistants to interact with HubSpot data, including contact management, company activity tracking, and real-time data access.

Customer data platform Artificial intelligence chatbots #HubSpot integration #CRM tool #AI assistant #Data interaction Remote .TypeScript

rating : 2 points

downloads : 4.2K

update time : 2025-04-28

Open Site

What is HubSpot MCP Server?

This is an intelligent bridge connecting AI assistants with HubSpot CRM, allowing you to perform customer relationship management operations through conversational instructions. The server uses the Model Context Protocol standard to transform complex CRM operations into simple natural language interactions.

How to use HubSpot MCP Server?

Simply enter an instruction like 'Help me create a contact named John from Acme Company in HubSpot' in the AI assistant interface, and the server will automatically convert it into a CRM operation. Administrators need to configure the API key and start the service first.

Use cases

It is particularly suitable for scenarios such as sales teams quickly updating customer information on the go, customer service representatives querying customer interaction history, and management viewing company activity reports.

Main features

Intelligent contact management

Supports automatic duplicate checking when creating/updating contacts to avoid data duplication

Enterprise activity insights

Visually displays all interaction records (emails/meetings/notes) of an enterprise

Omnichannel interaction tracking

Centrally view the timeline of cross-channel customer interactions

Real-time data synchronization

All operations are immediately reflected in HubSpot CRM

Advantages

Perform CRM operations without switching systems

Reduce the learning curve for new employees using HubSpot

Quickly complete complex queries through natural language

Ensure data consistency through real-time synchronization

Limitations

Require a stable network connection

Complex reports still need to be viewed using the native HubSpot interface

Technical assistance is required for the initial configuration

How to use

Get the API key

Create a private app in the HubSpot developer console and copy the generated access token

Configure the service

Set the token as an environment variable or startup parameter

Start the service

Run the service and connect the AI assistant

Usage examples

Quickly create a new customer

A sales representative creates a contact via voice immediately after a customer meeting

Customer follow-up query

A customer service representative queries all recent interactions with a customer

Frequently asked questions

What permissions are required to run it properly?

Will there be a delay in data updates?

Which AI assistant platforms are supported?

Related resources

HubSpot API documentation

Official API reference guide

MCP protocol standard

Protocol technical specification

Configuration video tutorial

10-minute quick start guide

🚀 HubSpot MCP Server

This is a Model Context Protocol (MCP) server designed to interact with the HubSpot CRM system. The server offers a variety of functions, including creating and updating contact and company information, retrieving activity history, and obtaining recent interaction data.

🚀 Quick Start

The HubSpot MCP Server is a powerful tool for interacting with the HubSpot CRM system. It provides a range of features to manage contacts, companies, and activities efficiently.

✨ Features

Developed in TypeScript: Written in modern TypeScript, ensuring code clarity and type safety.
Asynchronous Operations: Implements non - blocking IO operations through promises to enhance performance.
Modular Design: Adopts a modular structure for easy expansion and maintenance.
Comprehensive Documentation Support: Offers detailed API documentation and usage instructions.

📦 Installation

Clone the project repository:

git clone <repository-url>
cd hubspot-mcp-server

Install dependencies:
```
npm install
```

📚 Documentation

Configuration

Environment Variables: You need to set the HUBSPOT_API_KEY environment variable to ensure that the server can connect to the HubSpot API.

Usage Examples

Contact Management

Create a contact:

npm run create-contact -- [Name] [Email]

Update contact information:

npm run update-contact -- [Contact ID] [Attribute]

Company Management

Create a company:

npm run create-company -- [Company Name]

Update company information:

npm run update-company -- [Company ID] [Attribute]

Activity Record Query

Get the activity history of a specific company:
```
npm run get-company-activity -- [Company ID]
```

View recent engagements:

npm run get-recent-engagements -- [--days=7] [--limit=50]

Frequently Asked Questions

How to obtain an API key?
- Log in to your HubSpot account, find the developer tools in the settings, and generate a new API key.
What if the server fails to start?
- Check if the environment variables are set correctly and ensure that the network connection is normal.

Extension Instructions

New Features: You can easily add more HubSpot API features by extending the HubSpotClient class and registering new tools in the setupToolHandlers method.
Custom Logging: Modify the logging level as needed to achieve more detailed debugging information output.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific details.

Keywords

HubSpot, CRM, Model Context Protocol, MCP, AI Assistant, TypeScript, API Integration, HubSpot API, CRM Integration, Contact Management, Company Management, Interaction Tracking, AI Tools