Introducing ghealth: The Open-Source CLI for Your Google Health and Fitbit Data

Introducing ghealth: The Open-Source CLI for Your Google Health and Fitbit Data

The central development is this: In the evolving landscape of personal health data, accessing and analyzing information from wearables like Fitbit and Pixel Watch has become increasingly important for developers, researchers, and AI agents. The Google Health API v4, the official successor to the Fitbit Web API, provides a robust platform for this data. Now, an exciting open-source command-line interface (CLI) tool called ghealth has emerged, making interaction with this powerful API simpler and more efficient than ever before.

What is ghealth? A Powerful Wrapper for the Google Health API

Meanwhile, ghealth serves as a convenient wrapper around the Google Health API v4, streamlining the process of retrieving and managing your health data. Built as a single Go binary and released under the Apache 2.0 license, it offers a lightweight and portable solution for developers. Instead of directly navigating complex API calls and OAuth flows, ghealth abstracts these complexities, allowing users to focus on the data itself.

Designed for Developers and AI Agents

One of ghealth’s standout features is its explicit design as an “agent-first” tool. This means it’s crafted to be highly compatible with AI agents and automated scripts.

Every command executed through ghealth returns simplified, stable JSON output, making it easy to parse and integrate into various applications. Key features supporting this design include:

• Simplified JSON: Consistent, easy-to-read data structures.
• Deterministic Exit Codes: Predictable outcomes for scripting.
• –dry-run Flag: Test commands without making actual changes.
• –raw Flag: Access the original API response when needed.

In practical terms, The repository also provides two “Agent Skills” as SKILL.md files, which document authentication, setup, global flags, and all 40 data types, operations, and potential caveats, further aiding agent integration. ghealth is hosted under the Google-Health-API GitHub organization, alongside other long-standing Fitbit open-source projects.

Unlocking a Wealth of Health Data: 40+ Verified Types

ghealth provides access to a comprehensive array of health metrics, covering most Fitbit and Pixel Watch signals. With 40 verified data types exposed as structured JSON, you can delve deep into various aspects of personal health. Examples of available data include:

• Steps
• Heart Rate
• Sleep (including detailed stage-by-stage data)
• Weight
• Oxygen Saturation
• Heart Rate Variability
• Electrocardiogram (ECG, requiring specific scopes)

For example, Each data type supports a subset of operations. Common actions include list to retrieve records, rollup or daily-rollup for aggregated data, and reconcile to merge overlapping data points from multiple sources, mirroring the Reconciled Stream in the v4 API. For writable types such as exercise, sleep, weight, body fat, and height, you also have create, update, and delete operations.

Getting Started: Secure Setup and Personal Control

Setting up ghealth is a straightforward process, managed primarily through a single command: ghealth setup. A guided wizard walks you through the necessary steps, which involve configuring a Google Cloud Platform (GCP) project and creating a Desktop-type OAuth client in the Google Cloud Console.

That said, Crucially, ghealth emphasizes personal control and security: you bring your own OAuth credentials, meaning the tool holds no shared keys. Authentication tokens are securely stored under ~/.config/ghealth/ with restricted file permissions (0600) and refresh automatically.

Notably all Google Health API scopes are classified as Restricted, requiring a privacy and security review for production access. However, for personal use, you can easily authorize your own project against your own account to access data from your Fitbit, Pixel Watch, and connected third-party sources.

Practical Commands and Actionable Insights

Reading data with ghealth is designed to be consistent and intuitive across different types. Here are a few examples of how you can query your health data:

Interestingly, ghealth data heart-rate list –from today –limit 10Retrieves your 10 most recent heart rate readings from today.

ghealth data steps daily-rollup –from 2026-03-22 –to 2026-03-29Fetches daily step totals for a specified week.

However, ghealth data sleep list –limit 5 –detailProvides detailed sleep stage data (awake, deep, REM) for the last five nights.

By default, ghealth returns simplified JSON output. For the original API response, you can use the –raw flag. Additionally, you can format your output as CSV or a table using –format csv or –format table.

The -o flag allows you to write the output to a file while also printing a schema preview. For large datasets, ghealth handles pagination losslessly, providing a nextPageToken to fetch subsequent pages.

Real-World Use Cases for Your Health Data

Meanwhile, The structured output and agent-first design of ghealth open up numerous possibilities for leveraging your health data:

• AI-Powered Sleep Analysis: Pull several nights of detailed sleep data and pipe the JSON into an AI agent (like Claude Code or Codex). Ask the agent to summarize deep-sleep trends or identify patterns over the week.
• Workout Data Integration with Pandas: Export your exercise data in TCX format with GPS and heart rate information. Load it directly into a Pandas DataFrame for in-depth analysis and visualization of your workouts.
• Custom Health Dashboards: Query daily resting heart rate over a 30-day period, export it as CSV, and chart it in a Jupyter notebook or a custom dashboard to track long-term trends.

Why ghealth Stands Out

While direct access to the Google Health API v4 offers ultimate control, ghealth significantly reduces the boilerplate associated with authentication, formatting, and data retrieval. Compared to other unofficial CLIs, ghealth provides a stable, agent-first design with predictable JSON output and robust support for 40 verified data types, all within the trusted Google-Health-API GitHub organization.

In practical terms, For developers and AI agents seeking an efficient, reliable, and open-source way to interact with Google Health and Fitbit data, ghealth is an invaluable tool that simplifies complex processes and unlocks powerful insights. Dive into the repository to explore its capabilities and start leveraging your health data today!

Expert Perspective

From an industry angle, the clearest signal around ghealth CLI is how it may influence data. The story reads less like a one-day spike and more like a marker of broader movement.

The next phase will depend on how quickly teams, regulators, or customers react. In practice, that gives ghealth CLI room to reshape expectations across ghealth over the near term.

For readers focused on practical impact, the best next step is to watch what changes around health once attention turns into execution.

Frequently Asked Questions

Why does ghealth CLI matter right now?

Introducing ghealth: The Open-Source CLI for Your Google Health and Fitbit DataThe central development is this: In the evolving landscape of personal health data, accessing and analyzing information from wearables like Fitbit and Pixel Watch has become increasingly important for developers, researchers, and AI agents.

What broader change could ghealth CLI signal?

The Google Health API v4, the official successor to the Fitbit Web API, provides a robust platform for this data.

What should the market watch next around ghealth CLI?

Now, an exciting open-source command-line interface (CLI) tool called ghealth has emerged, making interaction with this powerful API simpler and more efficient than ever before.What is ghealth?

Source: https://www.marktechpost.com/2026/07/02/the-google-health-api-got-a-cli-ghealth-is-an-open-source-tool-for-your-fitbit-air-data/