View as Markdown
Google Health icon

Google Health ACTION

List Data Points

Read raw data points for any Google Health data type the dedicated tools do not cover — blood oxygen (oxygen-saturation), heart rate variability, respiratory rate, VO2 max, body temperature, exercise sessions, sedentary periods, altitude, swim lengths and more; see the dataType options for the full list. Prefer a dedicated tool where one exists, since those return compact pre-aggregated results while this returns raw records and can be large: Get Daily Step Count (steps), Get Daily Activity Summary (calories, distance, active minutes, floors), Get Heart Rate, Get Sleep Data, Get Body Measurements (weight, body fat), Get Nutrition and Hydration Logs (food, water). Example: dataType="oxygen-saturation", startDate="2026-08-24" → dataPoints with each reading's value and timestamp, newest first. Two pages of pageSize come back (default 50 → 100 records) and pageSize is capped at 500, so one call returns at most 1000 records; truncated: true means there were more — narrow the date range or raise pageSize up to that cap. food and food-measurement-unit are reference catalogues, not time series — the date range does not apply, the response sets dateFilterApplied: false, and you must not describe those results as belonging to a particular day. Not available here: total-calories, floors, and calories-in-heart-rate-zone are aggregate-only (use Get Daily Activity Summary); ECG and irregular-rhythm data need OAuth scopes this app does not request. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Google Health account once, then configure and run List Data Points from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_health-list-data-points",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_health: { authProvisionId: "apn_xxxxxxx" },
    dataType: "Data Type",
    startDate: "Start Date",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Data Points inputs
Property Type Description
dataType Data Type string
The Google Health data type to read, e.g. oxygen-saturation, heart-rate-variability, exercise, blood-glucose, vo2-max, sedentary-period.
Required
startDate Start Date string
Start date in YYYY-MM-DD format (e.g. 2026-08-24), in the user's own timezone. Defaults to today in UTC, which can be a day off from the user's local date late at night — pass an explicit date when the exact day matters.
Optional
endDate End Date string
End date in YYYY-MM-DD format, inclusive. Defaults to Start Date, i.e. a single day. For a whole week, set Start Date to the Monday and End Date to the Sunday.
Optional
pageSize Page Size integer
Records to request per page, up to 2 pages. Defaults to 50, which keeps the response small enough to reason over. Values above 500 are clamped to 500, so a single call returns at most 1000 records. sleep and exercise are capped at 25 per page by the API regardless of what is passed, and are large per record — leave this low for them.
Optional
fields Fields string[]
Top-level field names to keep on each record's payload, e.g. ["sampleTime", "percentage"] for oxygen-saturation or ["interval", "exerciseType"] for exercise. Omit to return the full payload, which is the usual choice here since the shape differs per data type — call once without this to see the available keys, then narrow on a follow-up if the response was large.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
google_health-list-data-points
Version
0.0.2
App
Google Health
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes