ghealth CLI
CLI для Google Health API: шаги, пульс, сон, вес, ЭКГ и еще 40 типов данных читаются в JSON и идут в комплекте с двумя скиллами
- 274 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Токены доступа к вашим данным о здоровье хранятся на диске открытым текстом в ~/.config/ghealth
- Читает чувствительные данные: пульс, ЭКГ, глюкозу, сон и питание
- Умеет записывать и удалять упражнения, сон, вес, рост и процент жира
Установка
- Работает в
Ручная установка
git clone https://github.com/Google-Health-API/google-health-cli.git && cd google-health-cli && go build -o ghealth .Нужен Go. Готовых бинарников и менеджера пакетов в README нет.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токены доступа к вашим данным о здоровье хранятся на диске открытым текстом в ~/.config/ghealth
- Читает чувствительные данные: пульс, ЭКГ, глюкозу, сон и питание
- Умеет записывать и удалять упражнения, сон, вес, рост и процент жира
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ghealth — консольная программа на Go для Google Health API v4. Она читает 40 проверенных типов данных: шаги, пульс, упражнения, сон, вес, сатурацию, вариабельность пульса, ЭКГ, глюкозу крови, питание и другие. Ответы приходят упрощенным JSON с детерминированными кодами выхода, есть флаги `--dry-run`, `--raw`, `--format table` и `--format csv`. Для большинства типов работают `list`, `get`, `rollup`, `daily-rollup` и `reconcile`. Пример: `ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29` дает суммы шагов по дням. Записывать, обновлять и удалять можно упражнения, сон, вес, процент жира и рост. Трек упражнения экспортируется командой `export-tcx` в TCX или CSV. Первая настройка идет через `ghealth setup`: проект GCP, клиент OAuth и вход в браузере; есть режим без браузера для агентов и CI. В репозиторий входят два скилла: общий с настройкой и флагами и второй, описывающий все 40 типов данных с примерами и подводными камнями. Отсутствующий день в сводке означает, что устройство не носили. Ноль шагов выглядит как запись со значением 0.
Для кого. Для разработчиков и аналитиков, которые подключают данные носимых устройств Google к своим сценариям, и для агентов, которым нужен надежный доступ к этим данным.
Подходит, если
- Нужна сводка шагов, пульса или сна за неделю для личного отчета или аналитики
- Записи об упражнении надо выгрузить с маршрутом в CSV для pandas
- Вес, процент жира или рост требуется занести или поправить из скрипта
- Агент должен отвечать на вопросы по здоровью пользователя только на основе разрешенных ему данных
- Нужны данные ЭКГ или уведомлений о нерегулярном ритме: для них есть отдельные права
Не подходит, если
- Нужны данные Apple Health или Garmin: ghealth работает только с Google Health API
- Вам нужен медицинский вывод: программа отдает числа и ничего не интерпретирует
- Нужна непрерывная серия по дням без пропусков: дни без синхронизации в выдаче отсутствуют и нулями не заполняются
- Нельзя создавать проект Google Cloud и клиент OAuth: без них вход невозможен
Пример запроса к агенту
Покажи суммы шагов по дням за прошлую неделю через ghealth и отметь дни, за которые данных нетОграничения
Нужен проект Google Cloud с включенным Google Health API и клиент OAuth типа «приложение для компьютера». Токены лежат открытым текстом в `~/.config/ghealth/credentials.json` с правами 0600, путь меняет `GHEALTH_CONFIG_DIR`. Установка сейчас идет сборкой из исходников: нужны Go и команда `go build -o ghealth .`. Права ЭКГ и уведомлений о нерегулярном ритме выдаются отдельно. Для шагов и расстояний `list` возвращает интервалы без значений, суммы дает `daily-rollup`. Записи асинхронны: API возвращает операцию, и результат проверяют чтением.
Как отключить. Удалите бинарник `ghealth`, папку `~/.config/ghealth/` с токенами и скиллы из папки скиллов агента. Доступ приложения можно отозвать в настройках аккаунта Google.
Частые вопросы
Как установить ghealth и подключить скиллы?
Клонируйте репозиторий и выполните `go build -o ghealth .`. Скиллы ставит `npx skills add https://github.com/Google-Health-API/google-health-cli`, а по отдельности — ссылки на папки `skills/ghealth` и `skills/ghealth-shared`.
Как войти без браузера, на сервере или в CI?
Выполните `ghealth auth login --non-interactive`: команда напечатает адрес входа и команду завершения. Откройте адрес на любом устройстве, а затем выполните `ghealth auth login --complete` с полученным кодом.
Почему list не показывает число шагов?
Для шагов и расстояния `list` возвращает интервалы времени без значений. Суммы за дни дает `ghealth data steps daily-rollup`.
Что значит отсутствующий день в daily-rollup?
Для шагов, расстояния, этажей, высоты и калорий отсутствие даты означает, что устройство не носили или оно не синхронизировалось. Запись с нулем означает настоящий ноль. Пустой день нельзя усреднять как ноль.
Что можно записывать через ghealth?
Упражнения, сон, вес, процент жира и рост: для них есть `create`, `update` и `delete`. Остальные типы данных только читаются.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор скиллов Google DeepMind для научных задач: доступ к биологическим и химическим базам, поиск литературы и структурная биология
MCP сервер для данных Apple Health: агент отвечает на вопросы о сне, тренировках и пульсе запросами SQL
Консольный клиент ScrapeAtlas: агент и скрипты получают публичные данные 49 площадок одной командой и готовый JSON
MCP сервер для Google Sheets и Google Drive: агент читает, меняет и создает таблицы, листы и диаграммы
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Плагин для Claude Code и MCP-сервер: более 1000 научных инструментов для биологии, химии и медицины, команды для сверки данных и скиллы-маршрутизаторы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ghealth (эта запись) | нет | 274 | ||
| Apple Health MCP Server | нет | не нужна | 575 | MCP-сервер для данных Apple Health с запросами SQL |
| Garmin MCP | нет | API-ключ | 1 426 | данные Garmin Connect через неофициальную интеграцию |
Коротко о README
README коротко представляет CLI и дает быстрый старт из трех команд. Дальше идут настройка, способы входа для интерактивного, безголового и облачного сценариев, таблица 40 типов данных с операциями, примеры чтения и записи, формат вывода и раздел о скиллах для агентов.