HubSpot CRM Integration via MCP

Overview

The HubSpot CRM Integration via MCP is an experimental implementation of the Model Context Protocol (MCP) designed to provide a standardized interface for accessing and managing HubSpot CRM data. This project offers comprehensive coverage of the HubSpot CRM API, enabling users to perform advanced operations on CRM objects, associations, and engagement details.

⚠️ WARNING: This server is experimental, and functionality is not guaranteed. Use at your own risk.

Features

• Complete HubSpot CRM API Coverage: Full support for all standard CRM objects (companies, contacts, deals, etc.).
• Advanced Association Management: Leverage CRM Associations v4 for managing relationships between objects.
• Batch Operations: Efficiently manage data with batch create, update, and delete operations.
• Type-Safe Validation: Built with Zod for robust parameter validation.
• Advanced Search and Filtering: Perform complex searches and filtering on CRM data.

Installation

Prerequisites

If you don't already have a HubSpot API key, follow the HubSpot API Guide to obtain an access token.

NPX (Recommended)

Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["@shinzolabs/hubspot-mcp"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Manual Download

1. Clone the repository:
   shell git clone https://github.com/shinzo-labs/hubspot-mcp.git
2. Install dependencies:
   shell pnpm i
3. Add the following to your claude_desktop_config.json:
   json { "mcpServers": { "hubspot": { "command": "node", "args": ["/path/to/hubspot-mcp/index.js"], "env": { "HUBSPOT_ACCESS_TOKEN": "your-token-here" } } } }

Smithery

Install automatically via Smithery:

npx -y @smithery/cli install @shinzo-labs/hubspot-mcp --client claude

API Operations

Core CRM Objects

Basic Object Operations

• crm_list_objects: List CRM objects with optional filtering and pagination.
• crm_get_object: Retrieve a single CRM object by ID.
• crm_create_object: Create a new CRM object.
• crm_update_object: Update an existing CRM object.
• crm_delete_object: Delete a CRM object.

Search and Batch Operations

• crm_search_objects: Search CRM objects using advanced filters.
• crm_batch_create_objects: Create multiple objects in a single request.
• crm_batch_update_objects: Update multiple objects in a single request.
• crm_batch_delete_objects: Delete multiple objects in a single request.

CRM Records Management

Companies

• Basic Operations:
• crm_create_company: Create a new company with validated properties.
• crm_update_company: Update an existing company.
• crm_get_company: Retrieve a single company by ID.
• crm_search_companies: Search companies with specific filters.
• Batch Operations:
• crm_batch_create_companies: Create multiple companies in a single request.
• crm_batch_update_companies: Update multiple companies in a single request.
• Property Management:
• crm_get_company_properties: Retrieve all available company properties.
• crm_create_company_property: Create a new company property.

Contacts

• Basic Operations:
• crm_create_contact: Create a new contact with validated properties.
• crm_update_contact: Update an existing contact's information.
• crm_get_contact: Retrieve a single contact by ID.
• crm_search_contacts: Search contacts with specific filters.
• Batch Operations:
• crm_batch_create_contacts: Create multiple contacts in a single request.
• crm_batch_update_contacts: Update multiple contacts in a single request.
• Property Management:
• crm_get_contact_properties: Retrieve all available contact properties.
• crm_create_contact_property: Create a new contact property.

Engagement Management

Calls

• Basic Operations:
• calls_create: Create a new call record.
• calls_get: Retrieve call details.
• calls_update: Update a call record.
• calls_archive: Archive a call.
• calls_list: List all calls.
• calls_search: Search calls.
• Batch Operations:
• calls_batch_create: Create multiple calls.
• calls_batch_read: Read multiple calls.
• calls_batch_update: Update multiple calls.
• calls_batch_archive: Archive multiple calls.

Emails

• Basic Operations:
• emails_create: Create a new email record.
• emails_get: Retrieve email details.
• emails_update: Update an email.
• emails_archive: Archive an email.
• emails_list: List all emails.
• emails_search: Search emails.
• Batch Operations:
• emails_batch_create: Create multiple emails.
• emails_batch_read: Read multiple emails.
• emails_batch_update: Update multiple emails.
• emails_batch_archive: Archive multiple emails.

Associations and Relationships

CRM Associations v4

• Basic Operations:
• crm_list_association_types: List available association types.
• crm_get_associations: Retrieve all associations between objects.
• crm_create_association: Create an association.
• crm_delete_association: Delete an association.
• Batch Operations:
• crm_batch_create_associations: Create multiple associations.
• crm_batch_delete_associations: Delete multiple associations.

Contributing

Contributions are welcome! For questions or concerns, contact [email protected].

License

This project is licensed under the MIT License.