create_custom_food
Create a custom food item in Garmin's nutrition library with per-serving nutritional values, returning foodId and servingId for logging.
Instructions
Create a custom food in the user's Garmin nutrition library
Creates a new food item with nutritional information per serving.
On success the response includes foodId and servingId needed for
log_custom_food. If the API returns no data (204), use
get_custom_foods(search=food_name) to retrieve those IDs.
All nutrient amounts are ABSOLUTE values per serving, not %DV.
Nutrition labels often print %DV for calcium/iron/vitamin D —
convert to absolute units before passing.
Args:
food_name: Name of the custom food (e.g. "Homemade Chocolate Cookies")
calories: Calories per serving
serving_unit: Unit for serving size (e.g. "G", "ML", "OZ"). Default "G"
number_of_units: Serving size in the specified unit. Default 100
brand_name: Brand or vendor name (e.g. "Three Bridges")
carbs: Carbohydrates in grams per serving
protein: Protein in grams per serving
fat: Total fat in grams per serving
fiber: Fiber in grams per serving
sugar: Sugar in grams per serving
saturated_fat: Saturated fat in grams per serving
sodium: Sodium in mg per serving
cholesterol: Cholesterol in mg per serving
potassium: Potassium in mg per serving
trans_fat: Trans fat in grams per serving
calcium: Calcium in mg per serving (NOT %DV)
iron: Iron in mg per serving (NOT %DV)
vitamin_d: Vitamin D in mcg per serving (NOT %DV)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"food_name": "<food_name>",
"calories": "<calories>"
},
"name": "create_custom_food"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fat | No | ||
| iron | No | ||
| carbs | No | ||
| fiber | No | ||
| sugar | No | ||
| sodium | No | ||
| calcium | No | ||
| protein | No | ||
| calories | Yes | ||
| food_name | Yes | ||
| potassium | No | ||
| trans_fat | No | ||
| vitamin_d | No | ||
| brand_name | No | ||
| cholesterol | No | ||
| serving_unit | No | G | |
| saturated_fat | No | ||
| number_of_units | No |