mcp-hubspot

This repository provides a Model Context Protocol (MCP) server for integrating AI models with HubSpot CRM, enabling interaction with HubSpot data through tools like contact management. It allows AI to

54
13

HubSpot MCP Server

Docker Hub
License: MIT

smithery badgesmithery badge

Overview

This is a Model Context Protocol (MCP) server designed to integrate AI models with HubSpot CRM, enabling interaction with HubSpot data through a standardized interface. It leverages Anthropic's MCP for seamless operation.

Components

Resources

No resources are implemented. Tools are the primary focus.

Example Prompts

Demonstrates example prompts for creating HubSpot contacts from LinkedIn profiles and retrieving company pipeline activities.

Tools

The server provides tools for managing HubSpot objects:

  • Contact Management: hubspot_create_contact creates contacts, checking for duplicates based on name and company.
  • Company Management: hubspot_create_company creates companies, checking for duplicates based on name, and hubspot_get_company_activity retrieves company activity history.
  • Engagement Tools: hubspot_get_recent_engagements retrieves recent activities, hubspot_get_recent_companies retrieves recently active companies, and hubspot_get_recent_contacts retrieves recently active contacts.

Installing via Smithery

Automatic installation for Claude Desktop via Smithery is supported.

Prerequisites

Requires a HubSpot access token, obtainable by creating a private app with specific scopes (tickets, CRM object read/write permissions, sales email read, etc.).

Docker Installation

Supports pulling from Docker Hub or building locally. Multi-platform publishing is supported via docker buildx.

Usage with Claude Desktop

Installing via Smithery

Automatic installation for Claude Desktop via Smithery is supported.

Docker Usage

Provides JSON configurations for running the server with Docker, including passing the access token as an environment variable or command-line argument.

Development

Development environment setup instructions are provided.

License

Licensed under the MIT License.

Repository

BA
baryhuang

baryhuang/mcp-hubspot

Created

December 27, 2024

Updated

March 28, 2025

Language

Python

Category

Sales