HubSpot MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching

Local serverstdio

What is the HubSpot MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help

What the server does

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. This server bridges AI models with your HubSpot account, providing direct access to contacts, companies, and engagement data. Built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.

  • Direct CRM Access — Connect Claude and other AI assistants to your HubSpot data without intermediary steps
  • Context Retention — Vector storage with FAISS enables semantic search across previous interactions
  • Zero Configuration — Simple Docker deployment with minimal setup

Credentials and setup notes

You'll need a HubSpot access token with these scopes: - crm.objects.contacts (read/write) - crm.objects.companies (read/write) - sales-email-read

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
hubspot_create_contactCreate contacts with duplicate prevention
hubspot_create_companyCreate companies with duplicate prevention
hubspot_get_company_activityRetrieve activity for specific companies
hubspot_get_active_companiesRetrieve most recently active companies
hubspot_get_active_contactsRetrieve most recently active contacts
hubspot_get_recent_conversationsRetrieve recent conversation threads with messages
hubspot_search_dataSemantic search across previously retrieved HubSpot data

Configuration

You'll need a HubSpot access token with these scopes: - crm.objects.contacts (read/write) - crm.objects.companies (read/write) - sales-email-read

VariableDescriptionRequired
HUBSPOT_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use HubSpot to hubspot create contact.”
  • “Use HubSpot to hubspot create company.”
  • “Use HubSpot to hubspot get company activity.”

Frequently asked questions

The token requires crm.objects.contacts (read/write), crm.objects.companies (read/write), and sales-email-read.