Hby HubSpot
Search CRM records
Returns contacts, companies, deals or other CRM records that match property filters or a text query.
Description
Set `objectType` to `contacts`, `companies`, `deals` or another object. Filters within a group combine with AND and groups combine with OR; the MCP tool takes up to five groups of six filters and returns up to 200 records per page.
search-crm-records.md
Search CRM records
Returns contacts, companies, deals or other CRM records that match property filters or a text query.
Set objectType to contacts, companies, deals or another object. Filters within a group combine with AND and groups combine with OR; the MCP tool takes up to five groups of six filters and returns up to 200 records per page.
Set up
Use the first option your agent supports.
MCP (official, remote)
Add this server to your agent's MCP settings, then sign in when asked.
{ "mcpServers": { "hubspot": { "url": "https://mcp.hubspot.com" } } }
Call the MCP tool search_crm_objects.
Server URL: https://mcp.hubspot.com
API (official)
- Base URL: https://api.hubapi.com
- Endpoint:
POST /crm/objects/2026-09/{objectType}/search - Auth: send the header
Authorization: Bearer $HUBSPOT_API_KEY - Docs: https://developers.hubspot.com/docs/api-reference/latest/overview
Before doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.
