HubSpot
About
Integrates with HubSpot CRM to enable contact creation, company management, and activity tracking directly from conversational interfaces
Details
- Repository
- lkm1developer/hubspot-mcp-server
- License
- MIT
Explore
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HubSpotCommand (node, npx, python, etc.)npxArguments-
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.
-
Argument 1
- 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:
npm install mcp-proxy-auth
2. Set the AUTH_SERVER_URL environment variable to point to your API key verification endpoint:
export AUTH_SERVER_URL=https://your-auth-server.com/verify
3. Run the SSE server with authentication:
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": "[email protected]",
"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": "[email protected]",
"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"
}
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
