HubSpot

by lkm1developer

9 stars
371 downloads
Not rated
GitHub

About

Integrates with HubSpot CRM to enable contact creation, company management, and activity tracking directly from conversational interfaces

Details

Author
lkm1developer
Repository
lkm1developer/hubspot-mcp-server
GitHub stars
9
Downloads
371
License
MIT License
Categories
Productivity, Design, Developer Tools, AI, API, Frontend, Search
Tags
#integration

- Create contacts and companies with duplicate checking
- Retrieve comprehensive company activity and engagement timelines
- Get recent engagement data across all contacts and companies
- Fetch lists of recently active companies and contacts
- Update existing contacts and companies by ID

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name HubSpot
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

npm install

npx mcp-proxy-auth node dist/index.js


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

1. Install the package:

bash
npm install mcp-proxy-auth

2. Set the AUTH_SERVER_URL environment variable to point to your API key verification endpoint:
bash
export AUTH_SERVER_URL=https://your-auth-server.com/verify

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

4. The SSE URL will be available at:

localhost:8080/sse?apiKey=apikey
``

Replace apikey with your actual API key for authentication.

The mcp-proxy-auth` package acts as a proxy that:
- Intercepts requests to your SSE server
- Verifies API keys against your authentication server
- Only allows authenticated requests to reach your SSE endpoint

hubspot_create_contact

Create a new contact in HubSpot with duplicate checking. Parameters: firstname (string, required), lastname (string, required), email (string, optional), properties (object, optional)

hubspot_create_company

Create a new company in HubSpot with duplicate checking. Parameters: name (string, required), properties (object, optional)

hubspot_get_company_activity

Get comprehensive activity history for a specific company. Parameters: company_id (string, required)

hubspot_get_recent_engagements

Get recent engagement activities across all contacts and companies. Parameters: days (number, optional, default: 7), limit (number, optional, default: 50)

hubspot_get_active_companies

Get most recently active companies from HubSpot. Parameters: limit (number, optional, default: 10)

hubspot_get_active_contacts

Get most recently active contacts from HubSpot. Parameters: limit (number, optional, default: 10)

hubspot_update_contact

Update an existing contact in HubSpot (ignores if contact does not exist). Parameters: contact_id (string, required), properties (object, required)

hubspot_update_company

Update an existing company in HubSpot (ignores if company does not exist). Parameters: company_id (string, required), properties (object, required)

The server exposes the following powerful HubSpot integration tools:

1. hubspot_create_contact
- Create a new contact in HubSpot with duplicate checking
- Parameters:
- firstname (string, required): Contact's first name
- lastname (string, required): Contact's last name
- email (string, optional): Contact's email address
- properties (object, optional): Additional contact properties like company, phone, etc.
- Example:

     {
"firstname": "John",
"lastname": "Doe",
"email": "john.doe@example.com",
"properties": {
"company": "Acme Inc",
"phone": "555-123-4567",
"jobtitle": "Software Engineer"
}
}

2. hubspot_create_company
- Create a new company in HubSpot with duplicate checking
- Parameters:
- name (string, required): Company name
- properties (object, optional): Additional company properties
- Example:

     {
"name": "Acme Corporation",
"properties": {
"domain": "acme.com",
"industry": "Technology",
"phone": "555-987-6543",
"city": "San Francisco",
"state": "CA"
}
}

3. hubspot_get_company_activity
- Get comprehensive activity history for a specific company
- Parameters:
- company_id (string, required): HubSpot company ID
- Returns detailed engagement data including emails, calls, meetings, notes, and tasks

4. hubspot_get_recent_engagements
- Get recent engagement activities across all contacts and companies
- Parameters:
- days (number, optional, default: 7): Number of days to look back
- limit (number, optional, default: 50): Maximum number of engagements to return
- Returns a chronological list of all recent CRM activities

5. hubspot_get_active_companies
- Get most recently active companies from HubSpot
- Parameters:
- limit (number, optional, default: 10): Maximum number of companies to return
- Returns companies sorted by last modified date

6. hubspot_get_active_contacts
- Get most recently active contacts from HubSpot
- Parameters:
- limit (number, optional, default: 10): Maximum number of contacts to return
- Returns contacts sorted by last modified date

7. hubspot_update_contact
- Update an existing contact in HubSpot (ignores if contact does not exist)
- Parameters:
- contact_id (string, required): HubSpot contact ID to update
- properties (object, required): Contact properties to update
- Example:

     {
"contact_id": "12345",
"properties": {
"email": "updated.email@example.com",
"phone": "555-987-6543",
"jobtitle": "Senior Software Engineer"
}
}

8. hubspot_update_company
- Update an existing company in HubSpot (ignores if company does not exist)
- Parameters:
- company_id (string, required): HubSpot company ID to update
- properties (object, required): Company properties to update
- Example:

     {
"company_id": "67890",
"properties": {
"domain": "updated-domain.com",
"phone": "555-123-4567",
"industry": "Software",
"city": "New York",
"state": "NY"
}
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

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

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.