# Contacts List

HubSpot

List contacts from a connected HubSpot account with selected properties and paging.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Contacts List (tool ID: hubspot.contacts-list). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Manage HubSpot records](https://scrollport.com/tools/hubspot-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Lists contacts from the connected HubSpot account. Billed per upstream request: one page (up to 100 contacts) is one request at $0.0025, so fetching 5 pages costs $0.0125 regardless of how many records come back.

**Inputs and outputs**

### Input

`max_pages` integer · optional

Upstream pages to fetch. Each page is one billed request.

minimum: 1 · maximum: 10

`query` object · optional

Query-string parameters passed to HubSpot, e.g. limit and properties.

### Output

`pages` number

Returned pages value.

`results` array

Returned results value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "hubspot.contacts-list",
  "input": {
    "query": {
      "limit": 100,
      "properties": "email,firstname,lastname"
    },
    "max_pages": 1
  }
}
```

### Output

```
{
  "pages": 1,
  "results": [
    {
      "id": "100000000001",
      "url": "https://app-eu1.hubspot.com/contacts/123456789/record/0-1/100000000001",
      "archived": false,
      "createdAt": "2026-07-27T12:19:07.156Z",
      "updatedAt": "2026-07-27T20:23:05.119Z",
      "properties": {
        "email": "ada@example.com",
        "lastname": "Lovelace (Sample Contact)",
        "firstname": "Ada",
        "createdate": "2026-07-27T12:19:07.156Z",
        "hs_object_id": "100000000001",
        "lastmodifieddate": "2026-07-27T20:23:05.119Z"
      }
    }
  ]
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own HubSpot account, which isn't connected yet.Open connect_url, approve access, then retry unchanged. example: {"query":{"limit":100},"max_pages":1}

---

Canonical page: https://scrollport.com/tools/providers/hubspot/contacts-list