buryhuang/mcp-hubspot

By buryhuang

Updated about 1 month ago

HubSpot MCP Server: AI-powered integration to manage contacts, companies, and engagements.

Image
Databases & Storage
Integration & Delivery
Machine Learning & AI
0

73

HubSpot MCP Server

HubSpot MCP Server is an open-source project enabling seamless integration with HubSpot CRM via the Model Context Protocol (MCP). This server allows AI models to interact dynamically with HubSpot contacts, companies, and engagements.

GitHub

GitHub starsGitHub forksGitHub watchers

Explore the source code and contribute at GitHub.

Features

  • Dynamic Resources:

    • hubspot://hubspot_contacts: Access HubSpot contacts.
    • hubspot://hubspot_companies: Access HubSpot companies.
    • hubspot://hubspot_recent_engagements: Access recent engagements from the last 3 days.
  • Auto-Update: Resources sync in real-time with HubSpot changes.

Usage with Claude Desktop

To use this project with Claude Desktop, configure the Docker setup as follows:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Quick Start

Prerequisites

You'll need a HubSpot access token:

  1. Create a private app in your HubSpot account.
  2. Define required scopes, including:
    • crm.objects.contacts.read
    • crm.objects.companies.read
    • Other permissions as necessary for your use case.
  3. Copy the generated access token securely.
Docker Installation

You can either pull the image or build it locally:

Option 1: Pull from Docker Hub

docker pull buryhuang/mcp-hubspot:latest

Option 2: Build Locally

docker build -t mcp-hubspot .

Run the Container

docker run   -e HUBSPOT_ACCESS_TOKEN=your_access_token_here   buryhuang/mcp-hubspot:latest
Cross-Platform Publishing

To build and publish the Docker image for multiple platforms:

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push

Development & Contribution

To set up a development environment:

pip install -e .

License

This project is licensed under the MIT License. Contributions are welcome!

GitHub

Explore the source code and contribute at GitHub.

Docker Pull Command

docker pull buryhuang/mcp-hubspot