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

- **Type:** MCP server
- **Install:** `agentstack add mcp-baryhuang-mcp-hubspot`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [baryhuang](https://agentstack.voostack.com/s/baryhuang)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [baryhuang](https://github.com/baryhuang)
- **Source:** https://github.com/baryhuang/mcp-hubspot

## Install

```sh
agentstack add mcp-baryhuang-mcp-hubspot
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# HubSpot MCP Server
[](https://hub.docker.com/r/buryhuang/mcp-hubspot) 
[](https://opensource.org/licenses/MIT)

## 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:

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

## Performance Features

- **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

## 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
# 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:

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

### Building Docker Image

To build the Docker image locally:

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

For multi-platform builds:

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

## Development

```bash
pip install -e .
```

## License

MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [baryhuang](https://github.com/baryhuang)
- **Source:** [baryhuang/mcp-hubspot](https://github.com/baryhuang/mcp-hubspot)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-baryhuang-mcp-hubspot
- Seller: https://agentstack.voostack.com/s/baryhuang
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.