Overview
Manage HubSpot CRM: contacts, deals, tickets, and marketing.
Setup
Run with npx:
npx -y @modelcontextprotocol/server-hubspotConfiguration
HUBSPOT_HUBS_TOKEN environment variableDocumentation
HubSpot MCP
Overview
The HubSpot MCP server enables AI agents to manage HubSpot CRM data including contacts, deals, tickets, and marketing. Perfect for sales automation and customer relationship management.
Features
- Contact Management: Create, update, search contacts
- Deal Management: Track deals and pipelines
- Ticket Management: Manage support tickets
- Company Data: Access company records
- Marketing: Manage campaigns and emails
Installation
npx -y @modelcontextprotocol/server-hubspot
Configuration
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-hubspot"],
"env": {
"HUBSPOT_HUBS_TOKEN": "your-private-app-token"
}
}
}
}
Private App Setup
- Go to HubSpot Settings → Apps → Private Apps
- Create a new private app
- Grant required scopes (contacts, deals, tickets, etc.)
- Copy the access token
Available Tools
| Tool | Description |
|---|---|
list_contacts | List CRM contacts |
get_contact | Get contact details |
create_contact | Create a new contact |
update_contact | Update contact info |
list_deals | List deals |
create_deal | Create a new deal |
list_tickets | List support tickets |
search_objects | Search any CRM object |
Usage Examples
Add a Contact
Create a contact for "Jane Smith" with email "jane@example.com" and company "Acme Corp".
Get Deal Pipeline
Show me all deals in the "Negotiation" stage.
Search Contacts
Find all contacts from "Acme Corp" who have opened an email in the last month.
Pros
- ✅ Full HubSpot CRM integration
- ✅ Sales and marketing automation
- ✅ Contact and deal management
Cons
- ❌ Requires HubSpot account
- ❌ Private app setup needed
- ❌ Limited to HubSpot ecosystem
