Search the FatSecret food database by name. Returns food items with basic nutrition info per serving. Use this to find food_id and serving_id needed for logging diary entries.

Args:

• query: Food name to search (e.g., "chicken breast", "jasmine rice")

• page: Page number for pagination (default: 0)

• max_results: Results per page, max 50 (default: 20)

Returns: List of foods with id, name, description (brief nutrition summary).

Get detailed nutrition information for a specific food by its food_id. Returns all available servings with full macro and micronutrient breakdown.

Use this after fatsecret_search_food to get the serving_id and nutrition data needed for logging.

Args:

• food_id: The FatSecret food ID (from search results)

Returns: Food name, servings list with serving_id, serving description, calories, protein, carbs, fat, and available micronutrients.

Create a food diary entry for the user. Logs a specific food + serving to a meal on a given date.

You need food_id and serving_id from fatsecret_search_food / fatsecret_get_food.

Args:

• food_id: FatSecret food ID

• food_entry_name: Display name (e.g., "Chicken Breast")

• serving_id: The serving size ID

• number_of_units: How many of that serving (e.g., 2.5 for "2.5 cups")

• meal: One of "breakfast", "lunch", "dinner", "other"

• date: Date as YYYY-MM-DD string (default: today)

Returns: Created food entry with nutrition totals.

Edit an existing food diary entry. Can change serving size, number of units, or meal type.

Args:

• food_entry_id: The entry ID to edit (from get_food_entries)

• food_entry_name: Updated display name (optional)

• serving_id: New serving ID (optional)

• number_of_units: New number of servings (optional)

• meal: New meal type (optional)

Returns: Updated entry with new nutrition values.

Delete a food diary entry by its ID.

Args:

• food_entry_id: The entry ID to delete

Returns: Confirmation of deletion.

Get all food diary entries for a specific date. Shows what was logged for each meal with full nutrition breakdown.

Args:

• date: Date as YYYY-MM-DD (default: today)

Returns: All food entries grouped by meal with calories, protein, carbs, fat per entry and daily totals.

Get daily calorie/macro totals for an entire month. Useful for tracking adherence and trends.

Args:

• month: Month (1-12)

• year: Year (e.g., 2026)

Returns: Daily totals for each logged day in the month.

Create a reusable meal template (e.g., "Post-Workout Chicken & Rice"). After creating, add foods to it with fatsecret_add_food_to_saved_meal.

Args:

• saved_meal_name: Name for the template

• saved_meal_description: Optional description

• meal_type: Default meal type when copied to diary

Returns: Created saved meal with its ID.

Add a food item to an existing saved meal template.

Args:

• saved_meal_id: ID of the saved meal

• food_id: FatSecret food ID to add

• food_entry_name: Display name

• serving_id: Serving size ID

• number_of_units: Number of servings

Returns: Confirmation with nutrition details.

Get all saved meal templates for the user. Shows meal names, IDs, and food items within each.

Returns: List of saved meals with their IDs, names, and food contents.

Copy all foods from a saved meal template into the food diary for a specific date and meal.

Args:

• saved_meal_id: ID of the saved meal to copy

• meal: Target meal type

• date: Target date YYYY-MM-DD (default: today)

Returns: Confirmation that entries were created.

Log a weight measurement for a specific date.

Args:

• weight_kg: Weight in kilograms

• date: Date YYYY-MM-DD (default: today)

• comment: Optional note

Returns: Confirmation of logged weight.

Get weight entries for an entire month. Useful for tracking weight trends during bulk/cut phases.

Args:

• month: Month (1-12)

• year: Year (e.g., 2026)

Returns: All weight entries for the month with dates.

Get the user's recently eaten foods for quick re-logging. Returns food IDs and serving info ready to use with fatsecret_create_food_entry.

Returns: List of recently logged foods with IDs and serving details.

Copy all food entries from one date to another. Useful for repeating a day's meals.

Args:

• from_date: Source date YYYY-MM-DD

• to_date: Target date YYYY-MM-DD

Returns: Confirmation.