Search HubSpot CRM
hubspot_searchSearch HubSpot CRM objects (contacts, companies, deals) using full-text queries and property filters to find specific records.
Instructions
Search contacts, companies, or deals using full-text query and/or property filters.
Args:
objectType: "contacts" | "companies" | "deals"
query (string): Full-text search string (e.g. "Acme Corp" or "john@example.com")
filters: Array of property filters: [{ propertyName: "email", operator: "EQ", value: "john@example.com" }] Operators: EQ, NEQ, CONTAINS_TOKEN, NOT_CONTAINS_TOKEN, GT, GTE, LT, LTE, HAS_PROPERTY, NOT_HAS_PROPERTY
properties (string[]): Property names to include in results
sortBy (string): Property name to sort by
sortDirection: "ASCENDING" | "DESCENDING"
limit (number): 1-100 results (default 20)
after (string): Pagination cursor
Returns: { total: number, results: HubSpotRecord[], hasMore: boolean, nextCursor?: string }
Examples:
Find a contact by email: objectType="contacts", filters=[{propertyName:"email",operator:"EQ",value:"jane@example.com"}]
Find open deals: objectType="deals", filters=[{propertyName:"dealstage",operator:"NEQ",value:"closedwon"}]
Find companies in a city: objectType="companies", filters=[{propertyName:"city",operator:"EQ",value:"Boston"}]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| objectType | Yes | CRM object type to search | |
| query | No | Full-text search query string | |
| filters | No | Property filters to narrow results | |
| properties | No | Property names to include in the response | |
| sortBy | No | Property name to sort by | |
| sortDirection | No | Sort direction | ASCENDING |
| limit | No | Number of results (1-100) | |
| after | No | Pagination cursor |