buryhuang/mcp-hubspot repository overview

⁠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

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⁠.