/hubspot | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
hubspot_list_contacts | List contacts from HubSpot CRM with pagination support |
hubspot_get_contact | Retrieve detailed information about a specific HubSpot contact |
hubspot_create_contact | Create a new contact in HubSpot CRM |
hubspot_update_contact | Update an existing contact in HubSpot CRM |
hubspot_delete_contact | Permanently delete a contact from HubSpot CRM |
hubspot_search_contacts | Search for contacts in HubSpot CRM using text queries |
hubspot_get_user_details | Get authenticated user details and account information from HubSpot |
hubspot_list_objects | List objects of a specific type from HubSpot |
hubspot_search_objects | Search objects of a specific type in HubSpot |
hubspot_batch_create_objects | Create multiple objects in HubSpot in a single batch operation |
hubspot_batch_update_objects | Update multiple objects in HubSpot in a single batch operation |
hubspot_batch_read_objects | Read multiple objects from HubSpot in a single batch operation |
hubspot_get_schemas | Get all object schemas from HubSpot |
hubspot_list_properties | List all properties for a specific object type in HubSpot |
hubspot_get_property | Get a specific property definition from HubSpot |
hubspot_create_property | Create a new custom property in HubSpot |
hubspot_update_property | Update an existing property in HubSpot |
hubspot_create_association | Create an association between two objects in HubSpot |
hubspot_list_associations | List associations for a specific object in HubSpot |
hubspot_get_association_definitions | Get association type definitions between two object types in Hubspot |
hubspot_create_engagement | Create an engagement (note, task, call, email, meeting) in HubSpot |
hubspot_get_engagement | Get a specific engagement from HubSpot |
hubspot_update_engagement | Update an existing engagement in HubSpot |
hubspot_list_workflows | List workflows from HubSpot |
hubspot_get_workflow | Get a specific workflow from HubSpot |
hubspot_generate_feedback_link | Generate a feedback link for HubSpot MCP tools |
hubspot_get_link | Generate HubSpot UI URL for a specific object |
hubspot_create_deal | Create a deal in HubSpot with pipeline and stage |
hubspot_get_deal | Get a specific deal by ID from HubSpot |
hubspot_update_deal | Update an existing deal in HubSpot |
hubspot_create_company | Create a company in HubSpot |
hubspot_get_company | Get a specific company by ID from HubSpot |
hubspot_update_company | Update an existing company in HubSpot |
hubspot_create_note | Create a note and optionally associate it with contacts, companies, or deals |
hubspot_list_deals | List deals in HubSpot with filtering and pagination |
hubspot_list_companies | List companies in HubSpot with filtering and pagination |
hubspot_get_deal_activities | Get recent activities (engagements) associated with a deal. Returns calls, emails, meetings, notes, and tasks linked to the specified deal. |
hubspot_list_products | List products from HubSpot product library |
hubspot_get_product | Get a specific product by ID from HubSpot |
hubspot_list_line_items | List line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices. |
hubspot_get_line_item | Get a specific line item by ID from HubSpot |
hubspot_list_orders | List orders from HubSpot. Orders represent e-commerce purchases. |
hubspot_get_order | Get a specific order by ID from HubSpot |
hubspot_list_invoices | List invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API. |
hubspot_get_invoice | Get a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API. |
hubspot_create_post | Create a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately. |
hubspot_update_post | Update an existing blog post in HubSpot CMS. Only provided fields will be updated. |
hubspot_get_publish_channels | Get the list of connected social media publishing channels (LinkedIn, X/Twitter, etc.) for the current HubSpot account. Use this to discover available channel GUIDs before creating a broadcast. |
hubspot_list_broadcasts | List social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels. |
hubspot_get_broadcast | Get details of a specific social media broadcast by its GUID. |
hubspot_create_broadcast | Create a new social media broadcast (post) in HubSpot for publishing to LinkedIn or X (Twitter). Use hubspot_get_publish_channels first to get the channelGuid for the desired social account. HubSpot’s v1 Broadcast API has no true draft state, and any missing/past/near-now triggerAt causes HubSpot to publish immediately — so by default this tool schedules the post 90 days out (landing in HubSpot’s Scheduled queue for human review). Pass publishImmediately=true to publish now (only when the user has explicitly asked for that), or pass a specific future triggerAt to schedule for a specific time. To attach an image to the post, put its public URL in content.photoUrl (use hubspot_upload_file first if you need a stable HubSpot-hosted URL). |
hubspot_delete_broadcast | Delete a social media broadcast from HubSpot. Only drafts and scheduled broadcasts can be deleted; already published broadcasts cannot be removed. |
hubspot_upload_file | Upload a file to HubSpot’s File Manager by fetching it from a public source URL. Returns the HubSpot-hosted public URL, which can be passed as content.photoUrl to hubspot_create_broadcast to attach an image to a LinkedIn or X post. Use this when you have a temporary/signed URL or want a stable HubSpot-hosted copy. |
hubspot_list_contacts
List contacts from HubSpot CRM with pagination support Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Maximum number of contacts to return (default: 10, max: 100) |
hubspot_get_contact
Retrieve detailed information about a specific HubSpot contact Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contactId | string | Yes | — | The unique HubSpot identifier of the contact to retrieve |
hubspot_create_contact
Create a new contact in HubSpot CRM Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
properties | object | Yes | — | Contact properties as key-value pairs (e.g., {“email”: “john@example.com”, “firstname”: “John”}) |
hubspot_update_contact
Update an existing contact in HubSpot CRM Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contactId | string | Yes | — | The unique HubSpot identifier of the contact to update |
properties | object | Yes | — | Contact properties to be updated as key-value pairs |
hubspot_delete_contact
Permanently delete a contact from HubSpot CRM Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contactId | string | Yes | — | The unique HubSpot identifier of the contact to delete |
hubspot_search_contacts
Search for contacts in HubSpot CRM using text queries Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query to find contacts (searches across email, name, company, phone, and other contact properties) |
limit | number | No | 10 | Maximum number of contacts to return (default: 10, max: 100) |
hubspot_get_user_details
Get authenticated user details and account information from HubSpothubspot_list_objects
List objects of a specific type from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of object to list (e.g., contacts, companies, deals, tickets) |
limit | number | No | — | Maximum number of objects to return |
after | string | No | — | Pagination cursor to get next set of results |
hubspot_search_objects
Search objects of a specific type in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of object to search (e.g., contacts, companies, deals, tickets) |
query | string | No | — | Search query string to find objects |
filters | object[] | No | — | Array of filter conditions to apply to the search |
limit | number | No | — | Maximum number of objects to return |
hubspot_batch_create_objects
Create multiple objects in HubSpot in a single batch operation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of objects to create (e.g., contacts, companies, deals, tickets) |
objects | object[] | Yes | — | Array of objects to create, each with their properties |
hubspot_batch_update_objects
Update multiple objects in HubSpot in a single batch operation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of objects to update (e.g., contacts, companies, deals, tickets) |
objects | object[] | Yes | — | Array of objects to update, each with their ID and updated properties |
hubspot_batch_read_objects
Read multiple objects from HubSpot in a single batch operation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of objects to read (e.g., contacts, companies, deals, tickets) |
ids | string[] | Yes | — | Array of object IDs to retrieve |
properties | string[] | No | — | Specific properties to retrieve for each object |
hubspot_get_schemas
Get all object schemas from HubSpothubspot_list_properties
List all properties for a specific object type in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The object type to list properties for (e.g., contacts, companies) |
hubspot_get_property
Get a specific property definition from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The object type the property belongs to (e.g., contacts, companies, deals etc.) |
propertyName | string | Yes | — | The name of the property to retrieve |
hubspot_create_property
Create a new custom property in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The object type to create the property for (e.g., contacts, companies, deals etc.) |
property | object | Yes | — | Property definition object |
hubspot_update_property
Update an existing property in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The object type the property belongs to (e.g., contacts, companies, deals, tickets) |
propertyName | string | Yes | — | The name of the property to update |
property | object | Yes | — | Property update object with fields to modify |
hubspot_create_association
Create an association between two objects in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fromObjectType | string | Yes | — | The object type of the source object (e.g., contacts, companies, deals) |
fromObjectId | string | Yes | — | The ID of the source object |
toObjectType | string | Yes | — | The object type of the target object (e.g., contacts, companies, deals) |
toObjectId | string | Yes | — | The ID of the target object |
associationType | string | Yes | — | The type of association to create (e.g., primary, unlabeled) |
hubspot_list_associations
List associations for a specific object in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The object type of the source object (e.g., contacts, companies, deals) |
objectId | string | Yes | — | The ID of the source object to list associations for |
toObjectType | string | Yes | — | The object type to find associations to (e.g., contacts, companies, deals) |
hubspot_get_association_definitions
Get association type definitions between two object types in Hubspot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fromObjectType | string | Yes | — | The source object type (e.g., contacts, companies, deals) |
toObjectType | string | Yes | — | The target object type (e.g., contacts, companies, deals) |
hubspot_create_engagement
Create an engagement (note, task, call, email, meeting) in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
engagementType | string | Yes | — | Type of engagement to create. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
properties | object | Yes | — | Key-value pairs of engagement properties (e.g., subject, body, timestamp) |
associations | object[] | No | — | Optional array of objects to associate the engagement with |
hubspot_get_engagement
Get a specific engagement from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
engagementType | string | Yes | — | Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
engagementId | string | Yes | — | The unique identifier of the engagement to retrieve |
hubspot_update_engagement
Update an existing engagement in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
engagementType | string | Yes | — | Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
engagementId | string | Yes | — | The unique identifier of the engagement to update |
properties | object | Yes | — | Key-value pairs of engagement properties to update |
hubspot_list_workflows
List workflows from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | — | Maximum number of workflows to return |
hubspot_get_workflow
Get a specific workflow from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workflowId | string | Yes | — | The unique identifier of the workflow to retrieve |
hubspot_generate_feedback_link
Generate a feedback link for HubSpot MCP toolshubspot_get_link
Generate HubSpot UI URL for a specific object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
objectType | string | Yes | — | The type of object to generate a link for (e.g., contacts, companies, deals, tickets) |
objectId | string | Yes | — | The unique identifier of the object to generate a link for |
hubspot_create_deal
Create a deal in HubSpot with pipeline and stage Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dealname | string | Yes | — | Name of the deal |
amount | string | No | — | Deal amount |
pipeline | string | No | — | Deal pipeline ID |
dealstage | string | No | — | Deal stage ID |
closedate | string | No | — | Expected close date (YYYY-MM-DD) |
dealtype | string | No | — | Type of deal (newbusiness, existingbusiness, etc.) |
description | string | No | — | Deal description |
hubspot_owner_id | string | No | — | HubSpot owner ID for the deal |
hubspot_get_deal
Get a specific deal by ID from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dealId | string | Yes | — | ID of the deal to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_update_deal
Update an existing deal in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dealId | string | Yes | — | ID of the deal to update |
dealname | string | No | — | Name of the deal |
amount | string | No | — | Deal amount |
dealstage | string | No | — | Deal stage ID |
closedate | string | No | — | Expected close date (YYYY-MM-DD) |
description | string | No | — | Deal description |
hubspot_create_company
Create a company in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Company name |
domain | string | No | — | Company domain/website |
industry | string | No | — | Company industry |
city | string | No | — | Company city |
state | string | No | — | Company state |
country | string | No | — | Company country |
phone | string | No | — | Company phone number |
numberofemployees | string | No | — | Number of employees |
annualrevenue | string | No | — | Annual revenue |
description | string | No | — | Company description |
hubspot_get_company
Get a specific company by ID from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | Yes | — | ID of the company to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_update_company
Update an existing company in HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | Yes | — | ID of the company to update |
name | string | No | — | Company name |
domain | string | No | — | Company domain/website |
industry | string | No | — | Company industry |
city | string | No | — | Company city |
phone | string | No | — | Company phone number |
description | string | No | — | Company description |
hubspot_create_note
Create a note and optionally associate it with contacts, companies, or deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | string | Yes | — | Content of the note |
timestamp | string | No | — | Timestamp for the note (ISO format) |
associatedObjectType | string | No | — | Type of object to associate with (contacts, companies, deals) |
associatedObjectId | string | No | — | ID of the object to associate the note with |
hubspot_list_deals
List deals in HubSpot with filtering and pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of deals to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
pipeline | string | No | — | Filter by pipeline ID |
dealstage | string | No | — | Filter by deal stage ID |
hubspot_list_companies
List companies in HubSpot with filtering and pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of companies to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
city | string | No | — | Filter by city |
industry | string | No | — | Filter by industry |
hubspot_get_deal_activities
Get recent activities (engagements) associated with a deal. Returns calls, emails, meetings, notes, and tasks linked to the specified deal. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dealId | string | Yes | — | ID of the deal to get activities for |
activityTypes | string[] | No | — | Types of activities to retrieve. If not specified, all types are retrieved. |
limit | number | No | 50 | Maximum number of activities per type to retrieve |
hubspot_list_products
List products from HubSpot product library Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of products to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_get_product
Get a specific product by ID from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
productId | string | Yes | — | ID of the product to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_list_line_items
List line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of line items to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_get_line_item
Get a specific line item by ID from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
lineItemId | string | Yes | — | ID of the line item to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_list_orders
List orders from HubSpot. Orders represent e-commerce purchases. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of orders to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_get_order
Get a specific order by ID from HubSpot Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
orderId | string | Yes | — | ID of the order to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_list_invoices
List invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | 10 | Number of invoices to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_get_invoice
Get a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
invoiceId | string | Yes | — | ID of the invoice to retrieve |
properties | string[] | No | — | Specific properties to retrieve |
hubspot_create_post
Create a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | The title of the blog post |
contentGroupId | string | Yes | — | The ID of the blog (content group) this post belongs to. Use hubspot_list_objects with objectType “blogs” or the HubSpot CMS API to find available blog IDs. |
postBody | string | Yes | — | The HTML body content of the blog post |
slug | string | No | — | URL slug for the post (auto-generated from title if not provided) |
metaDescription | string | No | — | Meta description for SEO |
postSummary | string | No | — | Summary/excerpt of the blog post (HTML) |
blogAuthorId | string | No | — | The ID of the blog author |
featuredImage | string | No | — | URL of the featured image |
state | string | No | "DRAFT" | Publish state of the post (default: DRAFT) |
htmlTitle | string | No | — | HTML title tag for the post (defaults to name if not provided) |
hubspot_update_post
Update an existing blog post in HubSpot CMS. Only provided fields will be updated. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
postId | string | Yes | — | The ID of the blog post to update |
name | string | No | — | Updated title of the blog post |
postBody | string | No | — | Updated HTML body content of the blog post |
slug | string | No | — | Updated URL slug |
metaDescription | string | No | — | Updated meta description for SEO |
postSummary | string | No | — | Updated summary/excerpt of the blog post (HTML) |
blogAuthorId | string | No | — | Updated blog author ID |
featuredImage | string | No | — | Updated URL of the featured image |
state | string | No | — | Updated publish state |
htmlTitle | string | No | — | Updated HTML title tag |
hubspot_get_publish_channels
Get the list of connected social media publishing channels (LinkedIn, X/Twitter, etc.) for the current HubSpot account. Use this to discover available channel GUIDs before creating a broadcast.hubspot_list_broadcasts
List social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
count | number | No | 20 | Number of broadcasts to return (default: 20) |
offset | number | No | — | Offset for pagination |
hubspot_get_broadcast
Get details of a specific social media broadcast by its GUID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
broadcastGuid | string | Yes | — | The GUID of the broadcast to retrieve |
hubspot_create_broadcast
Create a new social media broadcast (post) in HubSpot for publishing to LinkedIn or X (Twitter). Use hubspot_get_publish_channels first to get the channelGuid for the desired social account. HubSpot’s v1 Broadcast API has no true draft state, and any missing/past/near-now triggerAt causes HubSpot to publish immediately — so by default this tool schedules the post 90 days out (landing in HubSpot’s Scheduled queue for human review). Pass publishImmediately=true to publish now (only when the user has explicitly asked for that), or pass a specific future triggerAt to schedule for a specific time. To attach an image to the post, put its public URL in content.photoUrl (use hubspot_upload_file first if you need a stable HubSpot-hosted URL). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
channelGuid | string | Yes | — | The GUID of the social channel to publish to (get from hubspot_get_publish_channels) |
content | object | Yes | — | The broadcast content object |
triggerAt | number | No | — | Unix timestamp in milliseconds for when to publish the post. Must be at least 5 minutes in the future; anything missing, in the past, or within 5 minutes of now is clamped to 90 days from now so the post is scheduled (not published immediately) and can be reviewed in HubSpot’s Social tool. Ignored when publishImmediately is true. |
publishImmediately | boolean | No | — | Set to true to publish the post immediately instead of scheduling it. Overrides triggerAt. Default: false (safe, scheduled for human review). Use only when the user has explicitly asked to publish now. |
hubspot_delete_broadcast
Delete a social media broadcast from HubSpot. Only drafts and scheduled broadcasts can be deleted; already published broadcasts cannot be removed. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
broadcastGuid | string | Yes | — | The GUID of the broadcast to delete |
hubspot_upload_file
Upload a file to HubSpot’s File Manager by fetching it from a public source URL. Returns the HubSpot-hosted public URL, which can be passed ascontent.photoUrl to hubspot_create_broadcast to attach an image to a LinkedIn or X post. Use this when you have a temporary/signed URL or want a stable HubSpot-hosted copy.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourceUrl | string | Yes | — | Publicly accessible URL of the file to fetch and upload |
fileName | string | No | — | Optional filename to save as in HubSpot. If omitted, derived from the sourceUrl. |
folderPath | string | No | — | Optional HubSpot File Manager folder path to place the file in |

