Hubspot
Connect to HubSpot CRM to query and search CRM data, including contacts, companies, and leads.
This page covers the AIP Built-in Hubspot MCP. To use HubSpot’s official Remote MCP server, see the HubSpot MCP (Official) Setup Guide.
The Built-in Hubspot MCP currently provides read-only tools to meet HubSpot Marketplace requirements. Create, update, and delete tools are not provided.
Key Features
- Batch query of CRM objects
- Individual query and search for contacts, companies, and leads
- Query CRM object property information
- Batch query for notes, calls, emails, tasks, and products
- Advanced filtering for CRM object searches
Basic Information
Authentication Method
Uses OAuth 2.0 for authentication.
Supported MCP Tools
CRM Object Tools
crm_batch_read_objects
Read multiple CRM objects in a single request.
crm_list_objects
List CRM objects with optional filtering and pagination.
crm_get_object
Get a single CRM object by ID.
crm_search_objects
Search CRM objects using advanced filters.
Company Tools
crm_get_company
Get a single company by ID.
crm_search_companies
Search companies with specific filters.
crm_get_company_properties
Get all available company properties.
Contact Tools
crm_get_contact
Get a single contact by ID.
crm_search_contacts
Search contacts with specific filters.
crm_get_contact_properties
Get all available contact properties.
Lead Tools
crm_get_lead
Get a single lead by ID.
crm_search_leads
Search leads with specific filters.
crm_get_lead_properties
Get all available lead properties.
Activity and Product Batch Read Tools
notes_batch_read
Read multiple notes in a single request.
calls_batch_read
Read multiple calls in a single request.
emails_batch_read
Read multiple emails in a single request.
tasks_batch_read
Read multiple tasks in a single request.
products_batch_read
Read multiple products in a single request.
Usage Example
For example,
- When you enter the prompt “Show me the 10 most recently registered contacts”,
- The LLM calls the
crm_search_contactstool through MCP to search for contacts. - Then, it responds in the chat based on the tool call results.
Another example:
- When you enter “Show me details for a specific company and its available properties”,
- The LLM uses
crm_get_companyandcrm_get_company_propertiesto retrieve the company information and property list.
Notes
- The Built-in Hubspot MCP currently provides read-only tools only.
- It is recommended to approve only the minimum required permissions during OAuth authorization.
- Available data may vary depending on HubSpot API limits and workspace permissions.