# HubSpot MCP

An unofficial MCP server and skill for the HubSpot API: your agent reads CRM objects, builds property-change-history reports and runs cross-object queries offline.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 62
- Author: Servosity
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Servosity/msp-skills/tree/HEAD/skills/hubspot
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/hubspot-mcp

## What it does

The server covers HubSpot Sales Hub features and adds two things other HubSpot tools lack: offline cross-object queries and property-change-history reporting. It runs on your laptop, the code is open.

The installer drops two binaries into your user bin path: `hubspot-cli` for the command line and `hubspot-mcp` for the server itself. Claude, Codex and Cowork pick up the skill through `SKILL.md`. You then need an access token from your HubSpot portal: `HUBSPOT_ACCESS_TOKEN=<value> hubspot-cli doctor` verifies the credentials before anything touches real data.

Skip HTTP mode (`--transport http`), localhost included. This build validates a token but still lacks caps on request size and response time. That same mode is what remote agents such as ChatGPT and Copilot Studio need, and it is paused for now. Stick to the default stdio transport. The MCP tools write with your credentials, so grant the narrowest scope that works.

## Requirements
- Environment variables: `HUBSPOT_ACCESS_TOKEN`, `HUBSPOT_BASE_URL`, `HUBSPOT_OWNER_EMAIL`, `HUBSPOT_MCP_HTTP_TOKEN`, `HUBSPOT_USER_AGENT`, `PRINTING_PRESS_CLIENT_PROFILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: HubSpot

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- pull deals and contacts out of HubSpot into a local report
- build a report from a deal's property change history
- run cross-object CRM queries without shipping data to the cloud
- verify the access token before touching live data
- wire HubSpot into an agent over stdio without editing JSON

## Example prompts
- Check portal access: `HUBSPOT_ACCESS_TOKEN=<value> hubspot-cli doctor`
- Show the property change history for this deal over the last month

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [servosity/msp-skills](https://affpapa.org/en/nevibecode/by/servosity/msp-skills.md) — 20 cards

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