hubspot-mcp-server MCP Server

HubSpot CRM MCP server for Claude Desktop and any MCP client, free-tier compatible. 15 tools over contacts, deals, and pipelines, authenticated with either a HubSpot private-app token or a full OAuth app. Writes are…

Local serverstdio

What is the hubspot-mcp-server MCP Server?

hubspot-mcp-server source profile. From the maintainer documentation: “HubSpot CRM MCP server for Claude Desktop and any MCP client, free-tier compatible. 15 tools over contacts, deals, and pipelines, authenticated with either a HubSpot private-app token or a full OAuth app. Writes are idempotent, so a retried tool call replays its first result instead of creating a duplicate record, and every tool call is written to a PII-redacted audit trail, including the calls denied for a missing scope and the calls that errored.”

Installation

The documented pypi package is mcp-hubspot. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HUBSPOT_PRIVATE_APP_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
crm_search_contactsSearch contacts by free-text term, one page at a time
crm_list_contactsList contacts in id order with cursor pagination
crm_get_contactFetch one contact by id, served from the local cache
crm_create_contactCreate a contact, idempotent on a supplied or derived key
crm_update_contactOverwrite the properties passed and invalidate the cache entry
crm_delete_contactArchive (soft-delete) a contact
crm_batch_create_contactsCreate up to 100 contacts and report per-row failures
crm_search_dealsSearch deals by free-text term with cursor pagination
crm_get_dealFetch one deal by id, served from the local cache
crm_create_dealCreate a deal, idempotent on a supplied or derived key
crm_update_dealUpdate deal properties, including moving it to another stage
crm_delete_dealArchive (soft-delete) a deal
crm_list_pipelinesList deal pipelines with stages in display order (cached)
crm_get_pipelineFetch one pipeline with its ordered stages
crm_export_audit_logExport the session audit trail as JSON Lines

How to install the hubspot-mcp-server MCP Server

{
  "mcpServers": {
    "hubspot": {
      "command": "uvx",
      "args": [
        "mcp-hubspot"
      ],
      "env": {
        "HUBSPOT_PRIVATE_APP_TOKEN": "YOUR_HUBSPOT_PRIVATE_APP_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HUBSPOT_PRIVATE_APP_TOKENDeclared in the maintainer’s client configuration.Check documentation