hubspot_graphql_query
Run GraphQL queries against HubSpot CRM to fetch records, properties, and associations in one request, avoiding multiple REST calls.
Instructions
🟢 READ-ONLY · query · CRM GraphQL · POST /collector/graphql
Run a GraphQL query against HubSpot's CRM data graph and return the JSON result. Fetches records, properties and associations across objects in one round-trip — use it when a REST tool would need several calls or returns too much.
HubSpot's GraphQL endpoint supports queries only (no mutations), so this cannot change account data. Endpoint: https://api.hubapi.com/collector/graphql. Plan: Marketing Hub or Content Hub Professional/Enterprise. Scopes: collector.graphql_query.execute. Not available with a HubSpot service key; it needs a private app or OAuth token. Example: {"query": "query { CRM { contact_collection(limit: 3) { items { email firstname associations { company_collection__primary { items { name } } } } } } }"}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "hubspot_graphql_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The GraphQL query document (queries only — HubSpot exposes no mutations). | |
| variables | No | Optional variables object referenced by the query. | |
| operationName | No | Optional operation name when the document defines several. |