View as Markdown
Google Health icon

Google Health ACTION

Get Daily Step Count

Get the user's total step count per day — the tool for any "how many steps" question. Returns one pre-aggregated total per day, not raw samples. Use Get Daily Activity Summary instead when distance, calories, active minutes, or floors are wanted alongside steps. The range is inclusive and capped at 90 days, because these totals are server-aggregated. Example: startDate="2026-08-17", endDate="2026-08-23" → days: [{ date, steps: 8432 }, ...] plus totalSteps, averageSteps, daysRequested and daysWithData. Set dataSourceFamily="google-wearables" to count only tracker-recorded steps, excluding manual entries. Days the tracker never reported are omitted from days entirely, so daysWithData can be lower than daysRequested and averageSteps is the mean over daysWithData. An empty days array means nothing synced, not zero steps — totalSteps and averageSteps are null in that case rather than 0. 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 Get Daily Step Count 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-get-daily-steps",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_health: { authProvisionId: "apn_xxxxxxx" },
    startDate: "Start Date",
    endDate: "End 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.

Get Daily Step Count inputs
Property Type Description
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
dataSourceFamily Data Source string
Which data sources to include. all-sources (the default) counts everything. google-wearables counts only Fitbit trackers and Pixel Watches, excluding manually logged entries — use it when the user asks about what their watch or tracker recorded. Only applies to aggregated (roll-up) queries.
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-get-daily-steps
Version
0.0.3
App
Google Health
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes