hubspot-connector

Connect HubSpot CRM via MCP and manage contacts, companies, and deals.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/selrai-company/claude-workshop-kit --skill hubspot-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-connector
Source: https://github.com/selrai-company/claude-workshop-kit/tree/main/skills/hubspot-connector
Command: npx skills add https://github.com/selrai-company/claude-workshop-kit --skill hubspot-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of connecting a user's HubSpot account to the assistant and enables safe, conversational read and write access to CRM data without exposing the user to technical details.

Core Features & Use Cases

  • Conversational setup: A non-technical, step-by-step Phase 1 walkthrough to create a HubSpot Private App, collect the access token, and wire the MCP connector into the local Claude configuration.
  • MCP-powered operations: Use native mcp__hubspot__* tools to list, search, read, create, and update contacts, companies, deals, tickets, properties, associations, engagements, custom object schemas, and workflows.
  • Verification & robust error handling: Validates tokens, checks scopes, handles 401/403/429 errors with clear user-facing guidance, and avoids echoing credentials.
  • Use case: Quickly connect HubSpot, verify the connection, then ask for recent contacts, open deals, or to create/update CRM records with explicit user confirmation before changes.

Quick Start

Connect my HubSpot account and show my recent contacts.

Frequently Asked Questions about hubspot-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect my HubSpot CRM to my assistant using an MCP connector?

To connect HubSpot CRM, you need to create a HubSpot Private App to generate an access token, then write an MCP server entry into your local Claude configuration. The assistant provides a conversational walkthrough for this setup.

What CRM data can I manage through the HubSpot MCP connector?

You can manage HubSpot CRM data by invoking native mcp__hubspot__* tools to list, search, create, and update contacts, companies, deals, tickets, properties, associations, engagements, custom objects, and workflows.

Do I need a HubSpot Private App access token to read and update CRM records?

Yes, creating a HubSpot Private App access token is required. The connector validates your token, checks scopes, and handles 401/403/429 authorization and rate-limit errors with clear guidance to ensure safe access.

Can I create and update HubSpot deals and tickets conversationally without coding?

Yes, you can conversationally create and update HubSpot deals and tickets. The connector requires explicit user confirmation before making any changes to your CRM records, ensuring safe read and write access.

How does the HubSpot MCP connector handle authorization and rate-limit errors?

The HubSpot MCP connector handles authorization and rate-limit errors by validating tokens, checking scopes, and catching 401/403/429 HTTP responses. It provides clear user-facing guidance without exposing your credentials.

What do I need to configure before I can search HubSpot contacts and open deals?

Before searching HubSpot contacts and open deals, you need to generate a Private App access token and register the MCP server in your local configuration. This enables the mcp__hubspot__* tools for CRM operations.