Betterness
How it worksBett-iTutorialsAboutFor businesses ↗, opens Betterness One in a new tabLog inSign up
How it worksBett-iTutorialsAboutFor businesses: Betterness One ↗, opens Betterness One in a new tab
Log inSign up
Skip to content

Overview

  • What is Betterness

Connect

  • Connect by signing in
  • Claude custom connector
  • ChatGPT custom MCP server
  • Permissions
  • Connected apps
  • Privacy and data

Trust

  • Trust Center
  • Audit Trail
  • Limits & Scopes

Resources

  • Troubleshooting
  • Glossary

Server

Get started

  • Connect with an API Key
  • Authentication
  • First Tool Call

Clients

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • ChatGPT
  • OpenClaw / BetterClaw

Recipes

  • Health Overview
  • Order Labs
  • Upload Lab Results
  • Biomarker Gap Analysis
  • Connect Wearables
  • Health Profile

Tools

  • All Tools
  • Profile
  • Wearables
  • Health Data
  • Nutrition
  • Logging
  • Biomarkers
  • Documents
  • Lab Tests
  • Lab Records
  • Lab Orders
  • Lab Results
  • Purchases
  • Confirming Actions
  • Inbox
  • Training Program
  • Updates
  • Health Profile
Docs/Betterness/Tools/Logging

Logging Tools

Save, change and delete the meals, supplements, water and body measurements the user logs.


Each tool saves one entry the way the app saves it. Times are ISO-8601 instants (e.g. 2026-10-16T13:05:00Z) within the last 30 days; omit them for now. The same entry sent again within 10 minutes is treated as a retry and saved once. Tell the user what you saved.

log_meal

A meal or snack. Give at least one number, known or estimated, and tell the user that estimated numbers can be fixed with update_meal.

ParameterNotes
mealLabelRequired. Short name, e.g. "Oatmeal with banana"
eatenAtWhen it was eaten
kcal, proteinG, carbsG, fatG, fiberG, sugarG, sodiumMgNutrients, in kcal, grams and milligrams
descriptionLonger description of what was in it

log_supplement

A supplement or medication dose, e.g. "Magnesium glycinate 400 mg".

ParameterNotes
nameRequired. E.g. "Vitamin D3"
servingAs the user said it, e.g. "2000 IU" or "1 capsule"
takenAtWhen it was taken

log_water

ParameterNotes
mlRequired. Millilitres (1 fl oz = 29.6 ml)
takenAtWhen

log_measurement

A body measurement the user took themselves.

ParameterNotes
typeRequired. weight, blood_pressure, body_fat (percent) or waist
valueThe reading, for weight, body_fat or waist
unitkg or lb for weight; cm or in for waist
systolic, diastolicmmHg, for blood_pressure
measuredAtWhen it was measured

Changing and deleting entries

The user's own entries only: another account's id answers as not found. The AI app asks before running each one. The same change sent again within 10 minutes returns the first answer (duplicate: true) and changes nothing twice.

update_meal

Changes only the fields given; the rest of the meal (items, place, photo) stays. If the meal was changed in the app since it was read, nothing changes and the answer says to read it again. Returns the meal before and after.

ParameterNotes
mealIdRequired. From log_meal, or a meal's id in getMeals
mealLabel, eatenAt, descriptionNew values
kcal, proteinG, carbsG, fatG, fiberG, sugarG, sodiumMgNew numbers; the others stay

delete_meal

Deletes the meal and its photo. Parameter: mealId. Returns what was deleted.

update_supplement

For a supplement: name, serving, takenAt or nutrients (which replace the old ones). For a water entry: ml and takenAt. Required: entryId, from log_supplement or log_water, or the id in getSupplementsAndWater. Returns the entry before and after.

delete_supplement

Deletes a supplement or water entry. Parameter: entryId.

delete_measurement

Deletes a weight, blood pressure, body fat or waist reading the user entered. Readings from a scale, watch or other connected device are refused: they are changed in the device's app. To correct a reading, delete it and log the right one. Parameter: entryId from log_measurement.

Permission: log:write

PreviousNutritionNextBiomarkers
Betterness

Product

  • How it works
  • Bett-i
  • Connect your AI

Resources

  • Tutorials
  • Podcast

Company

  • About
  • News
  • Contact

Legal

  • Privacy
  • Terms
  • Health data
  • Delete your account

For businesses

  • Betterness One ↗, opens Betterness One in a new tab

News from Betterness: the Friday Letter, launches and stories, by email.

  • Instagram ↗, opens in a new tab
  • X ↗, opens in a new tab
  • YouTube ↗, opens in a new tab
  • LinkedIn ↗, opens in a new tab
Download on the App StoreGet it on Google Play
HIPAA, powered by Vanta

HIPAA compliance monitored by Vanta.

Betterness, Inc. · Betterness gives health information, not medical advice.