HubSpot MCP Server
About
The HubSpot MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. It provides a set of tools for performing CRM operations – such as creating, updating, and retrieving contacts and companies – through natural language…
Details
- License
- MIT license
Explore
- Create contacts and companies with duplicate checking
- Update existing contacts and companies
- Retrieve detailed company activity history
- Get recent engagement data across all objects
- List recently active companies and contacts
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
HubSpot MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- 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
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.
name
(string, required): Company name
company_id
(string, required): HubSpot company ID
days
(number, optional, default: 7): Number of days to look back
limit
(number, optional, default: 50): Maximum number of engagements to return
contact_id
(string, required): HubSpot contact ID to update
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 mcp server": {
"hubspot-mcp-server-meerkats-ai": {
"command": "npx",
"args": [
"mcp-proxy-auth",
"node",
"dist/index.js"
]
}
}
}
}McpServers
{
"hubspot-mcp-server-meerkats-ai": {
"command": "npx",
"args": [
"mcp-proxy-auth",
"node",
"dist/index.js"
]
}
}
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.
