This server provides a standardized interface for accessing and managing HubSpot CRM data and engagements using the Model Context Protocol (MCP).
Core CRM Operations: Perform CRUD operations on core CRM objects like companies, contacts, deals, tickets, products, line items, quotes, and custom objects.
Batch Processing: Create, update, or delete multiple CRM objects in a single request for improved efficiency.
Advanced Search: Execute complex searches with filters, sorting, and pagination.
Engagement Management: Manage engagements such as calls, emails, meetings, notes, and tasks, including tracking detailed activities and metadata.
Associations Management: Handle relationships between CRM objects, including creation, deletion, and batch operations.
Communication Preferences: Manage subscription statuses and preferences for contacts, including global subscribe/unsubscribe capabilities.
Custom Properties: Create and manage custom properties for companies, contacts, and leads.
Provides a standardized interface for accessing and managing HubSpot CRM data, including operations for companies, contacts, deals, tickets, and other CRM objects. Supports advanced association management, batch operations, search functionality, and property validation for efficient CRM data management.
Leverages Zod for type-safe parameter validation across all HubSpot API operations, ensuring data integrity when working with CRM objects and their properties.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@HubSpot MCP find contacts from companies in San Francisco"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server implementation for the HubSpot API, providing a standardized interface for accessing and managing CRM data.
Complete coverage of the HubSpot CRM API
Support for all standard CRM objects (companies, contacts, deals, etc.)
Advanced association management with CRM Associations v4
Company-specific endpoints with property validation
Batch operations for efficient data management
Advanced search and filtering capabilities
Type-safe parameter validation with Zod
Related MCP server: HubSpot MCP Server
If you don't have an API key, follow the steps here to obtain an access token. OAuth support is planned as a future enhancement.
There are several options to configure your MCP client with the server. For hosted/remote server setup, use Smithery's CLI with a Smithery API Key. For local installation, use npx or build from source. Each of these options is explained below.
To add a remote server to your MCP client config.json, run the following command from Smithery CLI:
npx -y @smithery/cli install @shinzo-labs/hubspot-mcpEnter your HUBSPOT_ACCESS_TOKEN when prompted.
If you are developing your own agent application, you can use the boilerplate code here.
To install the server locally with npx, add the following to your MCP client config.json:
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": [
"@shinzolabs/hubspot-mcp"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}Download the repo:
git clone https://github.com/shinzo-labs/hubspot-mcp.gitInstall packages (inside cloned repo):
pnpm iAdd the following to your MCP client config.json:
{
"mcpServers": {
"hubspot": {
"command": "node",
"args": [
"/path/to/hubspot-mcp/index.js"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}Variable | Description | Required? | Default |
| Access Token for Hubspot Application | Yes | |
| Port for Streamable HTTP transport method | No |
|
| Enable telemetry | No |
|
crm_list_objects: List CRM objects with optional filtering and pagination
crm_get_object: Get a single CRM object by ID
crm_create_object: Create a new CRM object
crm_update_object: Update an existing CRM object
crm_archive_object: Archive (delete) a CRM object
crm_search_objects: Search CRM objects using advanced filters
crm_batch_create_objects: Create multiple objects in a single request
crm_batch_read_objects: Read multipl objects in a single request
crm_batch_update_objects: Update multiple objects in a single request
crm_batch_archive_objects: Archive (delete) multiple objects in a single request
crm_create_company: Create a new company with validated properties
crm_update_company: Update an existing company
crm_get_company: Get a single company by ID
crm_search_companies: Search companies with specific filters
crm_batch_create_companies: Create multiple companies in a single request
crm_batch_update_companies: Update multiple companies in a single request
crm_get_company_properties: Get all available company properties
crm_create_company_property: Create a new company property
crm_create_contact: Create a new contact with validated properties
crm_update_contact: Update an existing contact's information
crm_get_contact: Get a single contact by ID
crm_search_contacts: Search contacts with specific filters
crm_batch_create_contacts: Create multiple contacts in a single request
crm_batch_update_contacts: Update multiple contacts in a single request
crm_get_contact_properties: Get all available contact properties
crm_create_contact_property: Create a new contact property
crm_create_lead: Create a new lead with validated properties
crm_update_lead: Update an existing lead's information
crm_get_lead: Get a single lead by ID
crm_search_leads: Search leads with specific filters
crm_batch_create_leads: Create multiple leads in a single request
crm_batch_update_leads: Update multiple leads in a single request
crm_get_lead_properties: Get all available lead properties
crm_create_lead_property: Create a new lead property
engagement_details_get: Get details of a specific engagement
engagement_details_create: Create a new engagement
engagement_details_update: Update an existing engagement
engagement_details_archive: Archive (delete) an engagement
engagement_details_list: List all engagements with filtering
engagement_details_get_associated: Get associated engagements
calls_create: Create a new call record
calls_get: Get call details
calls_update: Update a call record
calls_archive: Archive a call
calls_list: List all calls
calls_search: Search calls
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_create: Create a new email record
emails_get: Get email details
emails_update: Update an email
emails_archive: Archive an email
emails_list: List all emails
emails_search: Search emails
emails_batch_create: Create multiple emails
emails_batch_read: Read multiple emails
emails_batch_update: Update multiple emails
emails_batch_archive: Archive multiple emails
meetings_create: Create a new meeting
meetings_get: Get meeting details
meetings_update: Update a meeting
meetings_archive: Archive (delete) a meeting
meetings_list: List all meetings
meetings_search: Search meetings
meetings_batch_create: Create multiple meetings
meetings_batch_update: Update multiple meetings
meetings_batch_archive: Archive multiple meetings
notes_create: Create a new note
notes_get: Get note details
notes_update: Update a note
notes_archive: Archive a note
notes_list: List all notes
notes_search: Search notes
notes_batch_create: Create multiple notes
notes_batch_read: Read multiple notes
notes_batch_update: Update multiple notes
notes_batch_archive: Archive multiple notes
tasks_create: Create a new task
tasks_get: Get task details
tasks_update: Update a task
tasks_archive: Archive a task
tasks_list: List all tasks
tasks_search: Search tasks
tasks_batch_create: Create multiple tasks
tasks_batch_read: Read multiple tasks
tasks_batch_update: Update multiple tasks
tasks_batch_archive: Archive multiple tasks
crm_list_association_types: List available association types
crm_get_associations: Get all associations between objects
crm_create_association: Create an association
crm_archive_association: Archive (delete) an association
crm_batch_create_associations: Create multiple associations
crm_batch_archive_associations: Archive (delete) multiple associations
communications_get_preferences: Get contact preferences
communications_update_preferences: Update contact preferences
communications_unsubscribe_contact: Global unsubscribe
communications_subscribe_contact: Global subscribe
communications_get_subscription_definitions: Get subscription definitions
communications_get_subscription_status: Get status for multiple contacts
communications_update_subscription_status: Update status for multiple contacts
products_create: Create a product with the given properties and return a copy of the object, including the ID.
products_read: Read an Object identified by ID
products_update: Perform a partial update of an Object identified by ID. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
products_archive: Move an Object identified by ID to the recycling bin.
products_list: Read a page of products. Control what is returned via the properties query param. after is the paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.
products_search: Search products
products_batch_create: Create a batch of products
products_batch_read: Read a batch of products by internal ID, or unique property values. Retrieve records by the idProperty parameter to retrieve records by a custom unique value property.
products_batch_update: Update a batch of products by internal ID, or unique values specified by the idProperty query param.
products_batch_archive: Archive a batch of products by ID
Contributions are welcomed and encouraged! Please read CONTRIBUTING.md for guidelines on issues, contributions, and contact information.
Shinzo Labs collects limited anonymous telemetry from this server to help improve our products and services. No personally identifiable information is collected as part of this process. Please review the Privacy Policy for more details on the types of data collected and how to opt-out of this telemetry.
MIT
Archive (delete) a call record
Inputs: callId (required).
Archive (delete) multiple call records in a single request
Inputs: callIds (required).
Create multiple call records in a single request
Inputs: inputs (required).
Read multiple call records in a single request
Inputs: inputs (required).
Update multiple call records in a single request
Inputs: inputs (required).
Create a new call record
Inputs: properties (required), associations.
Get details of a specific call
Inputs: callId (required), associations, properties.
List all calls with optional filtering
Inputs: after, archived, associations, limit, +1 more.
Search calls with specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Update an existing call record
Inputs: callId (required), properties (required).
Get communication preferences for a contact
Inputs: contactId (required), subscriptionId.
Get all subscription definitions for the portal
Inputs: archived.
Get subscription status for multiple contacts
Inputs: contactIds (required), subscriptionId (required).
Subscribe a contact to all email communications
Inputs: contactId (required), portalSubscriptionLegalBasis, portalSubscriptionLegalBasisExplanation.
Unsubscribe a contact from all email communications
Inputs: contactId (required), portalSubscriptionLegalBasis, portalSubscriptionLegalBasisExplanation.
Update communication preferences for a contact
Inputs: contactId (required), preferences (required), subscriptionId (required).
Update subscription status for multiple contacts
Inputs: subscriptionId (required), updates (required).
Archive (delete) an association between two objects
Inputs: fromObjectId (required), fromObjectType (required), toObjectId (required), toObjectType (required).
Archive (delete) a CRM object
Inputs: objectId (required), objectType (required).
Archive (delete) multiple associations in a single request
Inputs: fromObjectType (required), inputs (required), toObjectType (required).
Archive (delete) multiple CRM objects in a single request
Inputs: objectIds (required), objectType (required).
Create multiple associations in a single request
Inputs: fromObjectType (required), inputs (required), toObjectType (required).
Create multiple companies in a single request
Inputs: inputs (required).
Create multiple contacts in a single request
Inputs: inputs (required).
Create multiple leads in a single request
Inputs: inputs (required).
Create multiple CRM objects in a single request
Inputs: inputs (required), objectType (required).
Create multiple CRM objects in a single request
Inputs: objectIds (required), objectType (required), idProperty, properties, +1 more.
Update multiple companies in a single request
Inputs: inputs (required).
Update multiple contacts in a single request
Inputs: inputs (required).
Update multiple leads in a single request
Inputs: inputs (required).
Update multiple CRM objects in a single request
Inputs: inputs (required), objectType (required).
Create an association between two objects
Inputs: associationTypes (required), fromObjectId (required), fromObjectType (required), toObjectId (required), +1 more.
Create a new company with validated properties
Inputs: properties (required), associations.
Create a new company property
Inputs: fieldType (required), groupName (required), label (required), name (required), +7 more.
Create a new contact with validated properties
Inputs: properties (required), associations.
Create a new contact property
Inputs: fieldType (required), groupName (required), label (required), name (required), +7 more.
Create a new lead with validated properties
Inputs: properties (required), associations.
Create a new lead property
Inputs: fieldType (required), groupName (required), label (required), name (required), +7 more.
Create a new CRM object
Inputs: objectType (required), properties (required), associations.
Get all associations of a specific type between objects
Inputs: fromObjectId (required), fromObjectType (required), toObjectType (required), after, +1 more.
Get a single company by ID with specific properties and associations
Inputs: companyId (required), associations, properties.
Get all properties for companies
Inputs: archived, properties.
Get a single contact by ID with specific properties and associations
Inputs: contactId (required), associations, properties.
Get all properties for contacts
Inputs: archived, properties.
Get a single lead by ID with specific properties and associations
Inputs: leadId (required), associations, properties.
Get all properties for leads
Inputs: archived, properties.
Get a single CRM object by ID
Inputs: objectId (required), objectType (required), associations, properties.
List all available association types for a given object type pair
Inputs: fromObjectType (required), toObjectType (required).
List CRM objects of a specific type with optional filtering and pagination
Inputs: objectType (required), after, archived, limit, +1 more.
Search companies with company-specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Search contacts with contact-specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Search leads with lead-specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Search CRM objects using filters
Inputs: filterGroups (required), objectType (required), after, limit, +2 more.
Update an existing company with validated properties
Inputs: companyId (required), properties (required).
Update an existing contact with validated properties
Inputs: contactId (required), properties (required).
Update an existing lead with validated properties
Inputs: leadId (required), properties (required).
Update an existing CRM object
Inputs: objectId (required), objectType (required), properties (required).
Archive (delete) an email record
Inputs: emailId (required).
Archive (delete) multiple email records in a single request
Inputs: emailIds (required).
Create multiple email records in a single request
Inputs: inputs (required).
Read multiple email records in a single request
Inputs: inputs (required).
Update multiple email records in a single request
Inputs: inputs (required).
Create a new email record
Inputs: properties (required), associations.
Get details of a specific email
Inputs: emailId (required), associations, properties.
List all emails with optional filtering
Inputs: after, archived, associations, limit, +1 more.
Search emails with specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Update an existing email record
Inputs: emailId (required), properties (required).
Archive (delete) an engagement
Inputs: engagementId (required).
Create a new engagement with details
Inputs: engagement (required), associations, metadata.
Get details of a specific engagement
Inputs: engagementId (required).
Get all engagements associated with an object
Inputs: objectId (required), objectType (required), activityTypes, endTime, +3 more.
List all engagements with optional filtering
Inputs: activityTypes, endTime, limit, offset, +1 more.
Update an existing engagement's details
Inputs: engagement (required), engagementId (required), metadata.
Archive (delete) a meeting
Inputs: meetingId (required).
Archive (delete) multiple meetings in a single request
Inputs: meetingIds (required).
Create multiple meetings in a single request
Inputs: inputs (required).
Update multiple meetings in a single request
Inputs: inputs (required).
Create a new meeting
Inputs: properties (required), associations.
Get details of a specific meeting
Inputs: meetingId (required), associations, properties.
List all meetings with optional filtering
Inputs: after, createdAfter, createdBefore, limit, +1 more.
Search meetings with specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Update an existing meeting
Inputs: meetingId (required), properties (required).
Archive (delete) a note
Inputs: noteId (required).
Archive (delete) multiple notes in a single request
Inputs: noteIds (required).
Create multiple notes in a single request
Inputs: inputs (required).
Read multiple notes in a single request
Inputs: inputs (required).
Update multiple notes in a single request
Inputs: inputs (required).
Create a new note
Inputs: properties (required), associations.
Get details of a specific note
Inputs: noteId (required), associations, properties.
List all notes with optional filtering
Inputs: after, archived, associations, limit, +1 more.
Search notes with specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Update an existing note
Inputs: noteId (required), properties (required).
Move an Object identified by ID to the recycling bin.
Inputs: productId (required).
Archive (delete) a batch of products by ID
Inputs: productIds (required).
Create a batch of products
Inputs: inputs (required).
Read a batch of products by internal ID, or unique property values. Retrieve records by the idProperty parameter to retrieve records by a custom unique value property.
Inputs: productIds (required), properties (required), propertiesWithHistory (required), idProperty.
Update a batch of products by internal ID, or unique values specified by the idProperty query param.
Inputs: inputs (required).
Create a product with the given properties and return a copy of the object, including the ID.
Inputs: properties (required).
Read a page of products. Control what is returned via the properties query param. after is the paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.
Inputs: after, limit, properties.
Read an Object identified by ID
Inputs: productId (required), associations, properties.
Search products
Inputs: filterGroups (required), after, limit, properties, +2 more.
Perform a partial update of an Object identified by ID. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
Inputs: productId (required), properties (required).
Archive (delete) a task
Inputs: taskId (required).
Archive (delete) multiple tasks in a single request
Inputs: taskIds (required).
Create multiple tasks in a single request
Inputs: inputs (required).
Read multiple tasks in a single request
Inputs: inputs (required).
Update multiple tasks in a single request
Inputs: inputs (required).
Create a new task
Inputs: properties (required), associations.
Get details of a specific task
Inputs: taskId (required), associations, properties.
List all tasks with optional filtering
Inputs: after, archived, associations, limit, +1 more.
Search tasks with specific filters
Inputs: filterGroups (required), after, limit, properties, +1 more.
Update an existing task
Inputs: properties (required), taskId (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 112 tools
Tools are well-differentiated by resource type (calls, emails, CRM objects, etc.) and action (create, get, update, archive, search), with clear boundaries. Minor ambiguity exists between 'list' and 'search' operations across resources, but descriptions clarify that 'list' retrieves all with optional filtering while 'search' uses specific filters, making them distinguishable.
Naming follows a highly consistent pattern throughout: resource_action (e.g., calls_create, crm_get_company) with batch operations as resource_batch_action (e.g., emails_batch_update). This verb_noun structure is uniformly applied across all 112 tools, making them predictable and easy to parse.
With 112 tools, the count is excessive for a single server, leading to cognitive overload and potential inefficiency. While the tools cover multiple HubSpot domains (CRM, communications, engagements), the sheer volume suggests over-fragmentation, such as having separate batch and single operations for each resource, which could be streamlined.
The tool set provides comprehensive CRUD and lifecycle coverage across all major HubSpot domains (calls, emails, CRM objects, engagements, meetings, notes, products, tasks). Each resource includes create, get, update, archive, list, and search operations, with batch variants for scalability, ensuring no obvious gaps for agent workflows.
Native MCP access to CRM contacts, organizations, deals and tasks with user permissions.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
335 MCP tools, 75 playbooks. AI-native CRM, email/SMS, events, OAuth.
MCP server for the HubSpot Integrations Center HubDB: search and retrieve integration data.
