calculate_tdee
ChatGPTSet up a daily calorie goal for weight loss, gain, or maintenance. Estimates how many calories the user burns per day based on age, sex, height, weight, and activity level, then creates a daily calorie target for the desired goal and pace. Use when the user wants to set a calorie goal, lose or gain weight, maintain weight, or figure out how much to eat.
create_food_calendar_account
ChatGPTCreate a TrueCal account for this connector user. Use this if the user found the connector before creating a web account.
fetch
ChatGPTFetch a specific meal or calendar event by ID from search. Returns full text, URL, and metadata.
food_calendar_connection_status
ChatGPTCheck whether this connector user is connected to a TrueCal account. Use this before logging meals if you are unsure the account is linked.
food_history_lookup
ChatGPTSearch the user's TrueCal history for previously logged items and return their macros. Use this to reuse prior matches before logging a new meal.
get_calorie_aggregate
ChatGPTGet aggregated calorie stats over a rolling window (default 7 days). Returns average daily calories consumed, total consumed, total allotted calories (goal), and a daily breakdown. Use when the user asks for a 7-day running average or total allotted vs actual.
get_daily_summary
ChatGPTGet the user's calorie and macro totals for a specific day, including goals and remaining amounts. Use when the user asks about their progress, how many calories they have left, or wants a summary of what they've eaten.
get_tdee_status
ChatGPTCheck the user's current daily calorie goal and progress. Returns the current goal, the burn estimate it was based on, and whether a recalculation is recommended. Use when the user asks what their calorie goal is, how many calories to eat, or wants a progress check.
get_weekly_trend
ChatGPTGet the user's recorded weight, available synced activity, and last 7 days of logged calories. Includes the latest weigh-in up to the selected date and measurements in that week, without requiring a calorie goal. Activity comes from data already synced to TrueCal, not direct device access. Use for weight history, activity, or weekly progress.
log_hydration
ChatGPTLog a plain water or hydration amount directly to TrueCal hydration tracking, separate from meals and nutrients. Use for water intake like "20 oz water"; use log_meal for drinks with calories, macros, supplements, or meaningful nutrition.
log_meal
ChatGPTLog a natural-language meal description through the current TrueCal food agent. Provide what the user ate plus a stable idempotency_key for safe retries; include meal_label, eaten_at, and timezone when available. Includes three introductory AI logging attempts per account; existing TrueCal access also applies.
log_weight
ChatGPTLog a weight entry to track progress toward the user's weight goal and keep calorie goals accurate over time. Use when the user reports a new weigh-in or says their weight is X.
meal_entry_copy_items
ChatGPTCopy exact component nodes from one logged meal entry to another, or create a new meal entry with those components. Use source_meal_entry_id/component_ids and optional target_meal_entry_id.
meal_entry_delete_item
ChatGPTDelete one exact component from a logged meal entry and recompute totals. Use meal_entry_id and component_id from meal_entry_list_recent.
meal_entry_list_recent
ChatGPTList recent logged meal entries for review and enabled meal-entry tools. Use this to find meal_entry_id and component_id from the component tree; canonical MCP edit/update tools are disabled during the hard cutover.
meal_entry_move_meal
ChatGPTMove a logged meal entry to a different date/time. Use meal_entry_id from meal_entry_list_recent.
meal_entry_undo_last
ChatGPTUndo the most recent logged meal by deleting it entirely. ONLY use this when the user explicitly says to delete, remove, or undo a meal. To change an amount, edit the meal in the TrueCal app.
meal_template_apply
ChatGPTApply a saved meal template to a target day (defaults to today).
meal_template_archive
ChatGPTArchive a saved meal template so it no longer appears in active template lists.
meal_template_list
ChatGPTList saved meal templates (favorite meal bundles) that can be logged again.
meal_template_revise
ChatGPTCreate a new immutable template revision from an existing logged meal entry. Use meal_entry_id.
meal_template_save
ChatGPTSave a logged meal entry as a reusable meal template bundle. Use meal_entry_id from meal_entry_list_recent.
meal_template_save_items
ChatGPTSave selected component nodes from a logged meal entry as a reusable meal template bundle. Use meal_entry_id and component_ids.
meal_template_update
ChatGPTUpdate a meal template name.
open_food_diary
ChatGPTOpen your food diary to see today’s logged calories and meals, recent food, and weekly progress. Reads existing records without logging or changing food.
search
ChatGPTSearch logged meals and calendar events for a query string. Returns a list of result IDs, titles, and URLs for use with fetch.
search_past_meals
ChatGPTSearch the user's meal history by food name or description. Use when the user mentions leftovers, "that thing I had", or wants to repeat a past meal. Returns meal summaries with meal_entry_id for tools that act on logged meal entries. Supports date filters like "yesterday", "last night", "this week", "Tuesday".
show_meal_receipt
ChatGPTShow an existing saved meal receipt. After log_meal returns status logged, call this tool with receipt_arguments, then once for each remaining_receipt_arguments batch when present. Use the exact saved IDs. Reads only those saved entries in the connected account. Does not log, change, or delete food.
update_calorie_goal
ChatGPTUpdate an existing daily calorie goal without re-entering body stats. Adjusts the goal type, target weight, pace, or target date and recalculates the daily calorie goal using the user's current burn estimate. Use when the user wants to change their goal or pace but keep their profile info the same.