hs_list_contacts

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

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

Browse all contacts in your HubSpot workspace. Returns contact IDs, names, emails, and properties. Paginate with limit and after parameters.

Parameters

Example call

Arguments

{
  "limit": 25
}

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_list_contacts","arguments":{"limit":25}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('hs_list_contacts', {
  "limit": 25
});

More examples

{
  "limit": 50,
  "after": "next_page_cursor_abc123"
}

Response shape

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of contact objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Contact ID"
          },
          "properties": {
            "type": "object",
            "description": "Contact properties (name, email, phone, etc.)"
          }
        }
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information",
      "properties": {
        "next": {
          "type": "object",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor for next page"
            },
            "link": {
              "type": "string",
              "description": "Next page link"
            }
          }
        }
      }
    }
  }
}

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.