# HubSpot

Connects AI assistants to HubSpot CRM via remote HTTP. It lets you query contacts, inspect deal pipelines, and review support tickets in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1166 installs
- Author: hubspot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/hubspot
- Updated: 2025-11-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hubspot-hubspot

## What it does

The server operates through the remote endpoint at `https://hubspot.run.tools`. Before running operations, it invokes `get_user_details` to verify the account identity and check read or write permissions across CRM objects. This security step blocks unauthorized requests early.

Data retrieval relies on `search_crm_objects` for filtered queries and `get_crm_objects` for batch record lookups. The search call reports total record counts, which helps when exploring larger datasets. To inspect schemas, tools like `get_properties` and `search_properties` expose property definitions and valid enumeration choices.

HubSpot owner identifiers differ from standard user IDs. Lookups through `search_owners` only accept specific owner IDs, so using a regular user ID will fail.

## Requirements
- Remote server: `https://hubspot.run.tools`
- Works with: HubSpot

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hubspot https://hubspot.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hubspot-hubspot --url https://hubspot.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hubspot-hubspot": {
            "url": "https://hubspot.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hubspot-hubspot": {
            "type": "http",
            "url": "https://hubspot.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hubspot-hubspot https://hubspot.run.tools
```

## When to use it
- search contacts and companies using filtered queries
- inspect deal pipelines and track open tickets
- fetch CRM property definitions and enumeration values
- retrieve multiple records of the same type in a single call

## Example prompts
- Find all HubSpot contacts associated with Acme Corp and list their deals
- Check the total count and status of all open support tickets
- Inspect the property definitions and allowed values for lead status

## Similar
- [hubspot-sales-audit](https://affpapa.org/en/nevibecode/skills/hubspot-sales-audit.md) — skill · ★ 81 repo stars
- [hubspot-sales](https://affpapa.org/en/nevibecode/plugins/hubspot-sales.md) — plugin · ★ 5 repo stars
- [hubspot-automation](https://affpapa.org/en/nevibecode/skills/davepoon-hubspot-automation.md) — skill · 126 installs
- [enrich-company-name](https://affpapa.org/en/nevibecode/skills/enrich-company-name.md) — skill · ★ 81 repo stars
- [sales-execution](https://affpapa.org/en/nevibecode/skills/sales-execution.md) — skill · 1900 installs
- [call-list](https://affpapa.org/en/nevibecode/skills/call-list.md) — skill · 1800 installs

## Other versions with the same name
- [HubSpot · mindstone](https://affpapa.org/en/nevibecode/mcp/hubspot.md) — ★ 14 repo stars
- [HubSpot · ](https://affpapa.org/en/nevibecode/mcp/docker-hubspot.md)

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
