HubSpot MCP Server

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

The server requires a HubSpot API access token. You can obtain one by:

1. Going to your HubSpot Developer Account
2. Creating a private app with the necessary scopes (contacts, companies, engagements)
3. Copying the generated access token

You can provide the token in two ways:

1. As an environment variable:

   HUBSPOT_ACCESS_TOKEN=your-access-token
   

2. As a command-line argument:

   npm start -- --access-token=your-access-token
   

For development, create a .env file in the project root to store your environment variables:

HUBSPOT_ACCESS_TOKEN=your-access-token

Usage

Starting the Server

# Start the server
npm start

# Or with a specific access token
npm start -- --access-token=your-access-token

# Run the SSE server with authentication
npx mcp-proxy-auth node dist/index.js

Implementing Authentication in SSE Server

The SSE server uses the mcp-proxy-auth package for authentication. To implement authentication:

1. Install the package:

   npm install mcp-proxy-auth