Skip to content
Back to search

mcp-hubspot

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 overcome HubSpot API limitations while improving response times.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/baryhuang--mcp-hubspot/badge.svg)](/listings/baryhuang--mcp-hubspot)

HTML

<a href="/listings/baryhuang--mcp-hubspot"><img src="/api/listings/baryhuang--mcp-hubspot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

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

Quick Start

# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# Or pull Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Docker Configuration

For manual configuration in Claude desktop:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # Optional persistent storage
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Building Docker Image

To build the Docker image locally:

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

For multi-platform builds:

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 114 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # HubSpot MCP Server
  2. [![Docker Hub](https://img.shields.io/docker/pulls/buryhuang/mcp-hubspot?label=Docker%20Hub)](https://hub.docker.com/r/buryhuang/mcp-hubspot)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. ## Overview
  5. 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.
  6. Our implementation prioritizes the most frequently used, high-value HubSpot operations with robust error handling and API stability. Each component is optimized for AI-friendly interactions, ensuring reliable performance even during complex, multi-step CRM workflows.
  7. ## Why MCP-HubSpot?
  8. - **Direct CRM Access**: Connect Claude and other AI assistants to your HubSpot data without intermediary steps
  9. - **Context Retention**: Vector storage with FAISS enables semantic search across previous interactions
  10. - **Zero Configuration**: Simple Docker deployment with minimal setup
  11. ## Example Prompts
  12. ```
  13. Create HubSpot contacts and companies from this LinkedIn profile:
  14. [Paste LinkedIn profile text]
  15. ```
  16. ```
  17. What's happening lately with my pipeline?
  18. ```
  19. ## Available Tools
  20. The server offers tools for HubSpot management and data retrieval:
  21. | Tool | Purpose |
  22. |------|---------|
  23. | `hubspot_create_contact` | Create contacts with duplicate prevention |
  24. | `hubspot_create_company` | Create companies with duplicate prevention |
  25. | `hubspot_get_company_activity` | Retrieve activity for specific companies |
  26. | `hubspot_get_active_companies` | Retrieve most recently active companies |
  27. | `hubspot_get_active_contacts` | Retrieve most recently active contacts |
  28. | `hubspot_get_recent_conversations` | Retrieve recent conversation threads with messages |
  29. | `hubspot_search_data` | Semantic search across previously retrieved HubSpot data |
  30. ## Performance Features
  31. - **Vector Storage**: Utilizes FAISS for efficient semantic search and retrieval
  32. - **Thread-Level Indexing**: Stores each conversation thread individually for precise retrieval
  33. - **Embedding Caching**: Uses SentenceTransformer with automatic caching
  34. - **Persistent Storage**: Data persists between sessions in configurable storage directory
  35. - **Multi-platform Support**: Optimized Docker images for various architectures
  36. ## Setup
  37. ### Prerequisites
  38. You'll need a HubSpot access token with these scopes:
  39. - crm.objects.contacts (read/write)
  40. - crm.objects.companies (read/write)
  41. - sales-email-read
  42. ### Quick Start
  43. ```bash
  44. # Install via Smithery (recommended)
  45. npx -y @smithery/cli@latest install mcp-hubspot --client claude
  46. # Or pull Docker image directly
  47. docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest
  48. ```
  49. ### Docker Configuration
  50. For manual configuration in Claude desktop:
  51. ```json
  52. {
  53. "mcpServers": {
  54. "hubspot": {
  55. "command": "docker",
  56. "args": [
  57. "run", "-i", "--rm",
  58. "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
  59. "-v", "/path/to/storage:/storage", # Optional persistent storage
  60. "buryhuang/mcp-hubspot:latest"
  61. ]
  62. }
  63. }
  64. }
  65. ```
  66. ### Building Docker Image
  67. To build the Docker image locally:
  68. ```bash
  69. git clone https://github.com/buryhuang/mcp-hubspot.git
  70. cd mcp-hubspot
  71. docker build -t mcp-hubspot .
  72. ```
  73. For multi-platform builds:
  74. ```bash
  75. docker buildx create --use
  76. docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .
  77. ```
  78. ## Development
  79. ```bash
  80. pip install -e .
  81. ```
  82. ## License
  83. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.