# Hubspot

> Hubspot is a freemium MCP server for sales and crm. MCP server giving AI clients read access to HubSpot CRM contacts, companies and deals. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web, vscode
- **Website:** https://pipeworx.io/packs/hubspot
- **Repository:** https://github.com/pipeworx-io/mcp-hubspot
- **MCP Registry name:** io.github.pipeworx-io/hubspot
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-18

## About

The README describes this as a HubSpot pack on the Pipeworx MCP gateway, so requests go through a hosted endpoint rather than directly from your machine. Seven tools cover listing and fetching contacts, companies and deals, plus a keyword search across contacts. Listing tools paginate with limit and after parameters, and fetch tools return custom properties along with linked records for deals.

The server is read-oriented: the documented tools retrieve IDs, names, emails, domains, industries, revenue, pipeline stages, amounts and close dates. The README notes that a connection also exposes shared Pipeworx meta-tools such as ask_pipeworx, which can route questions across other data sources.

It suits developers and sales-ops teams who want an AI assistant to look up CRM records during analysis or prospecting. The README says it is an independent, unofficial integration and is not affiliated with HubSpot.

## Features

- **Contact browsing and lookup:** Lists workspace contacts and fetches a full profile by ID, including custom properties.
- **Contact search:** Finds people by name, email or custom property values.
- **Company records:** Lists companies and retrieves domain, industry, revenue and custom fields for one company.
- **Deal pipeline access:** Lists deals with amounts, pipeline stages and close dates, and fetches linked contacts and companies.
- **Pagination support:** List tools accept limit and after parameters for paging through large workspaces.

## Good for

- Pulling a contact's details into an AI chat while preparing for a call
- Reviewing open deals and their stages in a conversational report
- Finding company records by domain or industry for account research
- Checking which contacts are linked to a specific deal

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hubspot https://gateway.pipeworx.io/hubspot/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/hubspot/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hubspot": {
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hubspot": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hubspot": {
      "serverUrl": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hubspot": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}
```

## Tools

- `hs_list_contacts`: Browse all contacts in your HubSpot workspace. Returns contact IDs, names, emails, and properties. Paginate with limit and after parameters.
- `hs_get_contact`: Fetch a contact's full profile by ID. Returns name, email, phone, company, and all custom properties.
- `hs_search_contacts`: Search contacts by name, email, or custom properties.
- `hs_list_companies`: Browse all companies in your HubSpot workspace. Returns company IDs, names, domains, and properties. Paginate with limit and after parameters.
- `hs_get_company`: Fetch a company's full profile by ID. Returns name, domain, industry, revenue, and all custom properties.
- `hs_list_deals`: Browse all deals in your HubSpot workspace. Returns deal IDs, names, amounts, pipeline stages, and close dates. Paginate with limit and after parameters.
- `hs_get_deal`: Fetch a deal's full details by ID. Returns deal name, amount, stage, owner, and linked contacts and companies.

## FAQ

### Does the server write data back to HubSpot?

The documented tools only list, search and fetch records; the README does not list any create or update tools.

### Is a Pipeworx key required?

No. Without a key calls are anonymous and capped at 50 per day; a free account raises the cap to 200 per day.

### Which MCP clients can connect?

The README gives setup steps for Claude Desktop, Claude Code, Cursor, VS Code and Claude.ai custom connectors, plus an npm stdio bridge.

### Is Hubspot free?

Hubspot has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Hubspot to Claude Code?

Run this command in your terminal: claude mcp add --transport http hubspot https://gateway.pipeworx.io/hubspot/mcp

### What are the best alternatives to Hubspot?

The closest alternatives to Hubspot are Pipeline CRM MCP by usefulapi, HubSpot MCP, Pipedrive MCP by usefulapi, Revamp CRM MCP by usefulapi and webCRM MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Pipeline CRM MCP by usefulapi](https://ai-powered.com/mcp/pipeline-crm-mcp-by-usefulapi): Pipeline CRM MCP by usefulapi is a freemium MCP server for sales and crm.
- [HubSpot MCP](https://ai-powered.com/mcp/hubspot-mcp): HubSpot MCP is an open-source MCP server for sales and crm.
- [Pipedrive MCP by usefulapi](https://ai-powered.com/mcp/pipedrive-mcp-by-usefulapi): Pipedrive MCP by usefulapi is a freemium MCP server for sales and crm.
- [Revamp CRM MCP by usefulapi](https://ai-powered.com/mcp/revamp-crm-mcp-by-usefulapi): Revamp CRM MCP by usefulapi is a freemium MCP server for sales and crm.
- [webCRM MCP by usefulapi](https://ai-powered.com/mcp/webcrm-mcp-by-usefulapi): webCRM MCP by usefulapi is a freemium MCP server for sales and crm.
- [Keap MCP by usefulapi](https://ai-powered.com/mcp/keap-mcp-by-usefulapi): Keap MCP by usefulapi is a freemium MCP server for sales and crm.
- [Salesforce](https://ai-powered.com/mcp/salesforce-2): Salesforce is a freemium MCP server for sales and crm.
- [Propstack MCP by usefulapi](https://ai-powered.com/mcp/propstack-mcp-by-usefulapi): Propstack MCP by usefulapi is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/hubspot-3
