HubSpot

by peakmojo

46 stars

573 downloads

Not rated

GitHub

About

Integrates with HubSpot CRM to enable AI-driven contact and company management, lead processing, and automated data analysis.

Details

Author: peakmojo
Repository: baryhuang/mcp-hubspot
GitHub stars: 46
Downloads: 573
License: MIT License
Categories: Cloud Service, Other, Design, Developer Tools, AI, API, Frontend, Infrastructure, Search

- Vector Storage: Utilizes FAISS for efficient semantic search and retrieval
- Thread-Level Indexing: Stores each conversation thread individually for precise retrieval
- Embedding Caching: Uses SentenceTransformer with automatic caching
- Persistent Storage: Data persists between sessions in configurable storage directory
- Multi-platform Support: Optimized Docker images for various architectures

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name HubSpot

Command (node, npx, python, etc.) docker
Arguments
- Argument 1 run
- Argument 2 -i
- Argument 3 --rm
- Argument 4 -e
- Argument 5 HUBSPOT_ACCESS_TOKEN=your_token
- Argument 6 -v
- Argument 7 /path/to/storage:/storage
- Argument 8 buryhuang/mcp-hubspot:latest
Environment
- HUBSPOT_ACCESS_TOKEN your_token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

npx -y @smithery/cli@latest install mcp-hubspot --client claude For manual configuration in Claude desktop:

json
{
"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"
]
}
}
}
```

`hubspot_create_contact`

Create contacts with duplicate prevention.

`hubspot_create_company`

Create companies with duplicate prevention.

`hubspot_get_company_activity`

Retrieve activity for specific companies.

`hubspot_get_active_companies`

Retrieve most recently active companies.

`hubspot_get_active_contacts`

Retrieve most recently active contacts.

`hubspot_get_recent_conversations`

Retrieve recent conversation threads with messages.

`hubspot_search_data`

Semantic search across previously retrieved HubSpot data.

The server offers tools for HubSpot management and data retrieval:

| Tool | Purpose |
|------|---------|
| hubspot_create_contact | Create contacts with duplicate prevention |
| hubspot_create_company | Create companies with duplicate prevention |
| hubspot_get_company_activity | Retrieve activity for specific companies |
| hubspot_get_active_companies | Retrieve most recently active companies |
| hubspot_get_active_contacts | Retrieve most recently active contacts |
| hubspot_get_recent_conversations | Retrieve recent conversation threads with messages |
| hubspot_search_data | Semantic search across previously retrieved HubSpot data |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

HubSpot MCP Server

Overview

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.

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.

Why MCP-HubSpot?

- 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

Example Prompts

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

What's happening lately with my pipeline?

Available Tools

The server offers tools for HubSpot management and data retrieval:

Performance Features

Setup

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

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

hubspot_create_contact

hubspot_create_company

hubspot_get_company_activity

hubspot_get_active_companies

hubspot_get_active_contacts

hubspot_get_recent_conversations

hubspot_search_data

Claude Desktop / Cursor

Linux

Macos

Windows

HubSpot MCP Server

Overview

Why MCP-HubSpot?

Example Prompts

Available Tools

Performance Features

Setup

Prerequisites

Quick Start

Install

More like this

Sequential Thinking

Aws Kb Retrieval Server

Filesystem

EverArt

Google Drive

Reactive Resume

`hubspot_create_contact`

`hubspot_create_company`

`hubspot_get_company_activity`

`hubspot_get_active_companies`

`hubspot_get_active_contacts`

`hubspot_get_recent_conversations`

`hubspot_search_data`