HubSpot MCP Tools & API Patterns

Document HubSpot MCP server tools and CRM Search API patterns.

39|17|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/wyre-technology/msp-claude-plugins --skill hubspot-mcp-tools-api-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: HubSpot MCP Tools & API Patterns
Source: https://github.com/wyre-technology/msp-claude-plugins/tree/main/msp-claude-plugins/hubspot/hubspot/skills/api-patterns
Command: npx skills add https://github.com/wyre-technology/msp-claude-plugins --skill hubspot-mcp-tools-api-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides comprehensive guidance on connecting to and utilizing the HubSpot MCP server, enabling efficient interaction with HubSpot CRM data through AI-powered tools.

Core Features & Use Cases

  • Connection & Authentication: Details on OAuth 2.0 + PKCE, environment variables, and Claude Desktop configuration for secure access.
  • Tool Reference: A complete catalog of tools for managing contacts, companies, deals, tickets, and activities, including their parameters.
  • CRM Search API: In-depth explanation of search patterns, operators, sorting, and pagination for precise data retrieval.
  • Rate Limiting & Error Handling: Strategies to manage API limits and troubleshoot common issues.
  • Use Case: An MSP needs to quickly find all contacts associated with companies in the 'Acme Corporation' that have a 'Customer' lifecycle stage and were created in the last month. This skill provides the tools and patterns to construct such a query.

Quick Start

Use the hubspot_search_contacts tool to find all contacts with the email domain 'example.com'.

Frequently Asked Questions about HubSpot MCP Tools & API Patterns

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

FAQPage Schema
How do I authenticate HubSpot API requests using OAuth 2.0?

To authenticate HubSpot API requests, this Skill details using OAuth 2.0 with PKCE, configuring environment variables, and setting up Claude Desktop to establish secure access to the HubSpot MCP server.

How do I search HubSpot CRM contacts, companies, and deals with specific filters?

To search HubSpot CRM contacts, companies, and deals, this Skill provides tools and operational patterns for the CRM Search API, covering specific search operators, sorting, and pagination for precise data retrieval.

What's the best way to handle HubSpot API rate limiting and errors?

Handling HubSpot API rate limiting and errors requires specific strategies; this Skill provides operational patterns to manage API limits and troubleshoot common issues during Streamable HTTP transport interactions.

Can I use HubSpot MCP tools to find contacts associated with a specific company?

Yes, you can use HubSpot MCP tools to find associated contacts by leveraging the documented CRM Search API patterns, allowing you to construct queries that filter contacts by company name and lifecycle stage.

Does the HubSpot MCP server support Streamable HTTP transport?

Yes, the HubSpot MCP server supports Streamable HTTP transport, providing a communication mechanism for interacting with CRM tools and managing your data efficiently through AI-powered interfaces.