connect-hubspot-mcp
Installation
SKILL.md
Connect Claude to HubSpot via MCP
Set up HubSpot's official remote MCP server so Claude can read and write CRM records conversationally: look up a contact, inspect a company's deals, spot-check the results of a cleanup, without writing a script for every question.
Three Ways to Reach a Portal
This toolkit can talk to HubSpot three ways. They overlap less than they appear to.
| Remote MCP server (this skill) | Agent CLI (/connect-hubspot-agent-cli) |
REST scripts (every scripted skill) | |
|---|---|---|---|
| Status | Generally available | Beta | v3/v4 paths, see /audit-api-usage |
| Auth | OAuth as you, via an MCP connector | OAuth as you, or a service key | Service key in .env |
| Best for | Lookups, spot-checks, judgment calls, small edits | Bulk and admin work driven from the terminal | Repeatable runs with a CSV audit trail and an abort threshold |
| Bulk reads | 200 records per page | Paginated, JSONL out | Paginated |
| Bulk writes | A few records at a time, each confirmed | JSONL in, dry run first | Batches of 100 |
| Delete or archive | Not available | Yes, guarded | Yes, guarded |
| Workflows | Not available | List, get, create, update, delete | Create, export, restore |
| Properties | Create only | Create, update, archive | Create |
| Runs headless (CI, scheduled) | No | With a service key | Yes |