
Hubspot
MCP server giving AI clients read access to HubSpot CRM contacts, companies and deals
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/hubspot/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"hubspot": {
"url": "https://gateway.pipeworx.io/hubspot/mcp"
}
}
}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.
