nutrition_plans module provides tools to view and manage customized diets
and meal plan templates assigned to clients.
Available Tools
list_nutrition_plans
List nutrition plans assigned to a client.
- Type: Read-only
- Important Input Fields:
clientId(string, optional): Filter plans for a specific client.page(integer, optional): Page number.limit(integer, optional): Items per page.
get_nutrition_plan
Retrieve detailed meal specifications and target macronutrient goals of a plan.
- Type: Read-only
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.
create_nutrition_plan [Write]
Create a coach-authored nutrition plan for a client.
- Type: Write
- Important Input Fields:
clientId(string, required): Unique client ID.- plan fields (required): Plan metadata, date window, targets, and slots.
update_nutrition_plan [Write]
Update metadata, status, date window, target macros, notes, or existing slots.
- Type: Write
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.- plan fields (optional): Provide only the fields that should change.
add_nutrition_plan_item [Write]
Add one food product, recipe, supplement, or custom item to an existing Nutrition V2 plan slot.
- Type: Write
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.slotId(string, required): Existing slot identifier.- item fields (required): The product, recipe, supplement, or custom item to add.
replace_nutrition_plan_item [Write]
Replace one planned Nutrition V2 item with another item.
- Type: Write
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.slotId(string, required): Existing slot identifier.itemId(string, required): Existing item identifier.- replacement item fields (required): The new item to place in the slot.
remove_nutrition_plan_item [Write]
Remove one item from an existing Nutrition V2 plan slot.
- Type: Write
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.slotId(string, required): Existing slot identifier.itemId(string, required): Existing item identifier.
materialize_nutrition_day [Write]
Create or refresh a concrete Nutrition V2 day for a client and date from one of the client’s plans.
- Type: Write
- Important Input Fields:
clientId(string, required): Unique client ID.planId(string, required): Unique identifier of the nutrition plan.date(string, required): Target date in YYYY-MM-DD format.
archive_nutrition_plan [Write]
Archive or soft-delete a client’s Nutrition V2 plan.
- Type: Write
- Important Input Fields:
planId(string, required): Unique identifier of the nutrition plan.
Natural Language Examples
- “List all nutrition plans created for client client_5f81.”
- “Retrieve details of the active diet plan plan_abc123.”
- “Add Greek yogurt to Jane’s breakfast slot in her active plan.”