Nutrilog
Write explicit nutrient data to Google Health.
nutrilog auth login
nutrilog log "Bean salad" --grams 350 --kcal 420 --protein 25 --fat 12 --carbs 48
nutrilog log --input meal.json
cat meal.json | nutrilog log --input -
nutrilog history
nutrilog history yesterday
nutrilog history 2026-08-17 2026-08-23
nutrilog history '2026-08-22T20:00:00+10:00' '2026-08-23T01:00:00+10:00'
nutrilog duplicate POINT_ID --protein 0
nutrilog delete POINT_ID
JSON input is a flat item carrying name, meal_type, optional time,
optional grams, and nutrient fields. Omit time to use the device's current
local time.
Every new entry needs kcal, protein, fat, and carbs; explicit zero is a
valid value. Use --nutrient NAME=GRAMS for another Google Health nutrient.
Explicit flags override the input.
grams is written to Google as a gram serving and survives reads. When
it is absent, the shared format treats the nutrients as a 100 g fallback.
duplicate always keeps the source and accepts the same overrides as log.
To correct an entry, duplicate it with the correction, inspect the result, then
delete the source explicitly. JSON overrides may use null to remove a value.
Missing legacy Google core macros render as zero in Nutrilog output. Other
unknown values stay null and are omitted from writes. --dry-run --json
shows the record without authenticating or writing.
nutrilog history reads today by default. Pass one date for that day or two
dates for an inclusive range; dates may be ISO dates, today, or yesterday.
Dates become UTC bounds using the device's local timezone. Offset-aware ISO
datetimes are exact bounds; the end datetime is exclusive. Entries are then
compared only in UTC. Totals sum reported values and ignore null; a total is
null only when no entry reports it.
OAuth tokens remain in ~/.config/nutrilog/tokens.json with mode 0600.
1 maintainer
Release files for nutrilog 0.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nutrilog-0.4.3.tar.gz | 49.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nutrilog-0.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 67.3 kB
Release files / nutrilog-0.4.3.tar.gz
| Download URL | nutrilog-0.4.3.tar.gz |
|---|---|
| Size | 49.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f1c0d92ecde3c138d23faf9554dbb49f058634789ee962412db08a6cf772fe8c
|
|
BLAKE2b-256 checksum How to use checksums |
59f04ecaef2a6d662b6c31bcf88fd2bebfb549cdcc87fdc700bbcea0c9722e4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 23, 2026.
Transparency logRelease files / nutrilog-0.4.3-py3-none-any.whl
| Download URL | nutrilog-0.4.3-py3-none-any.whl |
|---|---|
| Size | 18.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8ea79defc00e0199f5ade49eeac1b78e2aa7e7cd63af6696ed53414064f021db
|
|
BLAKE2b-256 checksum How to use checksums |
34e3c5799023a72739b47f4f258300f6ee0a29f8c3167c7fc076d81d1454ba45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 23, 2026.
Transparency log
