Skip to main content
Glama
ZLeventer

hubspot-mcp

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

hs_search_contacts

Full-text search across contacts

hs_get_contact

Get a contact by ID with associations

hs_contact_by_email

Look up contacts by exact email

hs_recent_contacts

Most recently created contacts, filterable by lifecycle stage

hs_create_contact

Create a new contact

hs_update_contact

Update properties on an existing contact

Companies (3)

Tool

Description

hs_search_companies

Full-text search across companies

hs_get_company

Get a company by ID with associations

hs_list_company_contacts

List contacts associated with a company

Deals (4)

Tool

Description

hs_search_deals

Full-text search across deals

hs_get_deal

Get a deal by ID with amount, stage, and associations

hs_deals_by_stage

List deals in a specific pipeline stage

hs_recent_deals

Most recently created deals, with optional open-only filter

Pipelines (2)

Tool

Description

hs_list_pipelines

List all pipelines with stage IDs

hs_pipeline_summary

Deal counts and total amounts by stage — funnel snapshot

Lists (3)

Tool

Description

hs_list_lists

List all contact lists (static and active)

hs_get_list

Get list metadata including member count

hs_list_members

Get contacts in a list

Marketing Emails (3)

Tool

Description

hs_list_email_campaigns

List marketing email campaigns

hs_get_email_campaign_stats

Opens, clicks, bounces, unsubscribes for an email

hs_list_marketing_emails

List emails filtered by state (DRAFT, SCHEDULED, PUBLISHED, ARCHIVED)

Forms (3)

Tool

Description

hs_list_forms

List all HubSpot forms

hs_get_form

Get full form definition including fields

hs_form_submissions

Get recent form submissions with field values

Workflows (2)

Tool

Description

hs_list_workflows

List all automation workflows

hs_get_workflow

Get full workflow details including triggers and actions

Properties (2)

Tool

Description

hs_list_properties

List all CRM properties for an object type

hs_get_property

Get full property definition including enum options

Owners (1)

Tool

Description

hs_list_owners

List HubSpot users that can be assigned to CRM records

Power / Escape Hatch (1)

Tool

Description

hs_crm_search

Structured CRM search with custom filters against any object type

Setup

1. Get a HubSpot Private App access token

  1. In HubSpot, go to Settings → Integrations → Private Apps

  2. Create a new private app

  3. Grant scopes: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.lists.read, automation, forms, marketing-email

  4. Copy 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-mcp

Environment variables

Variable

Required

Description

HUBSPOT_ACCESS_TOKEN

Yes

HubSpot Private App access token (pat-na1-...)

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