hubspot-mcp
Provides tools for managing HubSpot CRM, including contacts, companies, deals, pipelines, lists, marketing emails, forms, workflows, and properties.
hubspot-marketing-mcp
MCP server for HubSpot CRM — 33 tools covering contacts, companies, deals, pipelines, lists, marketing emails, forms, workflows, and properties.
Tools
Contacts (6)
Tool | Description |
| Full-text search across contacts |
| Get a contact by ID with associations |
| Look up contacts by exact email |
| Most recently created contacts, filterable by lifecycle stage |
| Create a new contact |
| Update properties on an existing contact |
Companies (3)
Tool | Description |
| Full-text search across companies |
| Get a company by ID with associations |
| List contacts associated with a company |
Deals (4)
Tool | Description |
| Full-text search across deals |
| Get a deal by ID with amount, stage, and associations |
| List deals in a specific pipeline stage |
| Most recently created deals, with optional open-only filter |
Pipelines (2)
Tool | Description |
| List all pipelines with stage IDs |
| Deal counts and total amounts by stage — funnel snapshot |
Lists (3)
Tool | Description |
| List all contact lists (static and active) |
| Get list metadata including member count |
| Get contacts in a list |
Marketing Emails (3)
Tool | Description |
| List marketing email campaigns |
| Opens, clicks, bounces, unsubscribes for an email |
| List emails filtered by state (DRAFT, SCHEDULED, PUBLISHED, ARCHIVED) |
Forms (3)
Tool | Description |
| List all HubSpot forms |
| Get full form definition including fields |
| Get recent form submissions with field values |
Workflows (2)
Tool | Description |
| List all automation workflows |
| Get full workflow details including triggers and actions |
Properties (2)
Tool | Description |
| List all CRM properties for an object type |
| Get full property definition including enum options |
Owners (1)
Tool | Description |
| List HubSpot users that can be assigned to CRM records |
Power / Escape Hatch (1)
Tool | Description |
| Structured CRM search with custom filters against any object type |
Setup
1. Get a HubSpot Private App access token
In HubSpot, go to Settings → Integrations → Private Apps
Create a new private app
Grant scopes:
crm.objects.contacts.read,crm.objects.companies.read,crm.objects.deals.read,crm.lists.read,automation,forms,marketing-emailCopy the access token
2. Configure Claude Desktop
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "hubspot-marketing-mcp"],
"env": {
"HUBSPOT_ACCESS_TOKEN": "pat-na1-xxxxxxxxxxxx"
}
}
}
}2a. Configure Claude Code (CLI)
claude mcp add hubspot -e HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxxxxxx -- npx -y hubspot-marketing-mcpEnvironment variables
Variable | Required | Description |
| Yes | HubSpot Private App access token ( |
License
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/hubspot-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server