Provides comprehensive access to HubSpot's CRM API, enabling management of CRM objects (companies, contacts, deals, leads), engagement records (calls, emails, meetings, notes, tasks), product management, association management between objects, and communication preferences with support for search, batch operations, and property management.
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 the last 7 days with deal value over $10k"
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) 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
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 |
|
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_delete_object: 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_update_objects: Update multiple objects in a single request
crm_batch_delete_objects: Delete multiple objects in a single request
Basic Operations:
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
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: Get all available company properties
crm_create_company_property: Create a new company property
Basic Operations:
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
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: Get all available contact properties
crm_create_contact_property: Create a new contact property
Basic Operations:
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
Batch Operations:
crm_batch_create_leads: Create multiple leads in a single request
crm_batch_update_leads: Update multiple leads in a single request
Property Management:
crm_get_lead_properties: Get all available lead properties
crm_create_lead_property: Create a new lead property
Basic Operations:
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_delete: Delete an engagement
engagement_details_list: List all engagements with filtering
engagement_details_get_associated: Get associated engagements
Basic Operations:
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
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
Basic Operations:
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
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
Basic Operations:
meetings_create: Create a new meeting
meetings_get: Get meeting details
meetings_update: Update a meeting
meetings_delete: Delete a meeting
meetings_list: List all meetings
meetings_search: Search meetings
Batch Operations:
meetings_batch_create: Create multiple meetings
meetings_batch_update: Update multiple meetings
meetings_batch_archive: Archive multiple meetings
Basic Operations:
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
Batch Operations:
notes_batch_create: Create multiple notes
notes_batch_read: Read multiple notes
notes_batch_update: Update multiple notes
notes_batch_archive: Archive multiple notes
Basic Operations:
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
Batch Operations:
tasks_batch_create: Create multiple tasks
tasks_batch_read: Read multiple tasks
tasks_batch_update: Update multiple tasks
tasks_batch_archive: Archive multiple tasks
Basic Operations:
crm_list_association_types: List available association types
crm_get_associations: Get 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
Basic Operations:
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
Bulk Operations:
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.
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), properties, associations.
List all calls with optional filtering
Inputs: limit, after, properties, associations, +1 more.
Search calls with specific filters
Inputs: filterGroups (required), properties, limit, after, +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: subscriptionId (required), contactIds (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), subscriptionId (required), preferences (required).
Update subscription status for multiple contacts
Inputs: subscriptionId (required), updates (required).
Create multiple associations in a single request
Inputs: fromObjectType (required), toObjectType (required), inputs (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: objectType (required), inputs (required).
Delete multiple associations in a single request
Inputs: fromObjectType (required), toObjectType (required), inputs (required).
Delete multiple CRM objects in a single request
Inputs: objectType (required), objectIds (required).
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: objectType (required), inputs (required).
Create an association between two objects
Inputs: fromObjectType (required), toObjectType (required), fromObjectId (required), toObjectId (required), +1 more.
Create a new company with validated properties
Inputs: properties (required), associations.
Create a new company property
Inputs: name (required), label (required), type (required), fieldType (required), +7 more.
Create a new contact with validated properties
Inputs: properties (required), associations.
Create a new contact property
Inputs: name (required), label (required), type (required), fieldType (required), +7 more.
Create a new lead with validated properties
Inputs: properties (required), associations.
Create a new lead property
Inputs: name (required), label (required), type (required), fieldType (required), +7 more.
Create a new CRM object
Inputs: objectType (required), properties (required), associations.
Delete an association between two objects
Inputs: fromObjectType (required), toObjectType (required), fromObjectId (required), toObjectId (required).
Delete a CRM object
Inputs: objectType (required), objectId (required).
Get all associations of a specific type between objects
Inputs: fromObjectType (required), toObjectType (required), fromObjectId (required), after, +1 more.
Get a single company by ID with specific properties and associations
Inputs: companyId (required), properties, associations.
Get all properties for companies
Inputs: archived, properties.
Get a single contact by ID with specific properties and associations
Inputs: contactId (required), properties, associations.
Get all properties for contacts
Inputs: archived, properties.
Get a single lead by ID with specific properties and associations
Inputs: leadId (required), properties, associations.
Get all properties for leads
Inputs: archived, properties.
Get a single CRM object by ID
Inputs: objectType (required), objectId (required), properties, associations.
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), properties, after, limit, +1 more.
Search companies with company-specific filters
Inputs: filterGroups (required), properties, limit, after, +1 more.
Search contacts with contact-specific filters
Inputs: filterGroups (required), properties, limit, after, +1 more.
Search leads with lead-specific filters
Inputs: filterGroups (required), properties, limit, after, +1 more.
Search CRM objects using filters
Inputs: objectType (required), filterGroups (required), properties, 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: objectType (required), objectId (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), properties, associations.
List all emails with optional filtering
Inputs: limit, after, properties, associations, +1 more.
Search emails with specific filters
Inputs: filterGroups (required), properties, limit, after, +1 more.
Update an existing email record
Inputs: emailId (required), properties (required).
Create a new engagement with details
Inputs: engagement (required), associations, metadata.
Delete an engagement
Inputs: engagementId (required).
Get details of a specific engagement
Inputs: engagementId (required).
Get all engagements associated with an object
Inputs: objectType (required), objectId (required), startTime, endTime, +3 more.
List all engagements with optional filtering
Inputs: limit, offset, startTime, endTime, +1 more.
Update an existing engagement's details
Inputs: engagementId (required), engagement (required), metadata.
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.
Delete a meeting
Inputs: meetingId (required).
Get details of a specific meeting
Inputs: meetingId (required), properties, associations.
List all meetings with optional filtering
Inputs: after, limit, createdAfter, createdBefore, +1 more.
Search meetings with specific filters
Inputs: filterGroups (required), properties, limit, after, +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), properties, associations.
List all notes with optional filtering
Inputs: limit, after, properties, associations, +1 more.
Search notes with specific filters
Inputs: filterGroups (required), properties, limit, after, +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 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: propertiesWithHistory (required), inputs (required), properties (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: limit, after, properties.
Read an Object identified by ID
Inputs: productId (required), properties, associations.
Search products
Inputs: filterGroups (required), query, limit, after, +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), properties, associations.
List all tasks with optional filtering
Inputs: limit, after, properties, associations, +1 more.
Search tasks with specific filters
Inputs: filterGroups (required), properties, limit, after, +1 more.
Update an existing task
Inputs: taskId (required), properties (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 111 tools
Every tool has a clearly distinct purpose with no ambiguity, as they are organized by resource type (e.g., calls, crm, emails) and action (e.g., create, get, update, batch operations). Overlap is minimal and intentional, such as list vs. search for filtering options, which are clearly differentiated in descriptions.
Tool names follow a highly consistent verb_noun pattern throughout, with a clear structure of resource_action (e.g., calls_create, crm_get_company). Minor variations like 'archive' vs. 'delete' in descriptions are consistent within contexts, and batch operations are uniformly prefixed with 'batch_'.
With 111 tools, the count is excessive and feels heavy for the HubSpot CRM domain, likely leading to cognitive overload for agents. While the tools cover many resources, the high number suggests over-fragmentation rather than a well-scoped set, making it difficult to manage efficiently.
The tool surface provides complete CRUD/lifecycle coverage across all major HubSpot resources (calls, communications, CRM objects, emails, engagements, meetings, notes, products, tasks), including batch operations and specific functionalities like subscriptions and associations. No obvious gaps exist for the CRM domain.
Read deals, persons, organizations, activities and pipelines; create and update CRM records.
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.
Read and write Less Annoying CRM contacts, notes, tasks, events, pipelines and groups.
Read and filter Beacon CRM records of any type; create, update, upsert, delete records; run exports.
