Skip to content
MCP server

Hubspot

MCP server giving AI clients read access to HubSpot CRM contacts, companies and deals

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Hubspot

Hubspot is a freemium MCP server for sales and crm. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/hubspot/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hubspot": {
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for higher usage

Prices change. Check pipeworx.io before you buy.

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

How AIPoweredBot checks servers