`hs_search_contacts`

Pack: hubspot · Endpoint: https://gateway.pipeworx.io/hubspot/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/hs_search_contacts for the schema, then POST the same URL with its arguments for the data.

Search contacts by name, email, or custom properties. Use when you need to find specific people in your database.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (e.g., name or email)
`limit`	number	no	Maximum number of results (default 10, max 100)

Example call

Arguments

{
  "query": "[email protected]"
}

curl

curl -X POST https://gateway.pipeworx.io/hubspot/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hs_search_contacts","arguments":{"query":"[email protected]"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('hs_search_contacts', {
  "query": "[email protected]"
});

More examples

{
  "query": "Sarah Smith",
  "limit": 20
}

Response shape

Field	Type	Description
`results`	array	Array of matching contact objects
`total`	number	Total number of matches

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of matching contact objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Contact ID"
          },
          "properties": {
            "type": "object",
            "description": "Contact properties"
          }
        }
      }
    },
    "total": {
      "type": "number",
      "description": "Total number of matches"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "hubspot": {
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hs_search_contacts