What actions are available for Shortcuts?

In the Shortcuts app, you'll find a robust set of 44 actions for Foodnoms within 8 categories: Foodnoms, Food, Goals, Library, Log, Meal Types, Meals, and Recipes.

Here's a full list of the actions and their descriptions:

ActionCategoryDescription
Open Foodnoms-Opens into the Foodnoms app to a specific view. Options include Food Log, Library, Goals, and Settings. When opening to the Food Log, includes an option to select a date, including presets for Today and Yesterday.
Open Foodnoms File-Opens the contents of a Foodnoms file and passes the contained data as a result.
Search-Navigates the user to search results for the specified criteria.

Text
Search criteria used when searching in Foodnoms.

Scope
Whether to search for generic foods, branded items, items in your library, or all of the above.
Create FoodFoodCreates a new food using the specified nutrients.

Name
The name of the new food.

Brand
The brand owner of the food, if applicable.

Barcode
The GTIN/UPC barcode of the food, if applicable.

Serving Size
The household serving size of the food. "Household serving size" refers to the portion of the serving size listed on a U.S. nutrition label that is outside the parentheses, typically stated in common household measures like "1 cup," "2 slices," or "1 bar." This is distinct from the gram weight or metric measure, which is typically listed in parentheses.

Serving Metric Unit
The unit of measurement for the serving size in metric terms. This is typically listed in parentheses on U.S. nutrition labels and includes units like grams (g) and milliliters (ml).

Serving Metric Weight/Volume
The numeric amount of the serving size in terms of the specified metric unit. This value corresponds to the measurement listed in parentheses on U.S. nutrition labels, such as "240" for 240 ml.

Values Represent
Specifies whether the numerical nutritional values correspond to the serving size or are normalized per 100g/ml. Typically in the U.S., nutritional values correspond to the serving size.

Immediately Save
Whether to save the created food to your food library, or pass it as output.
Copy Logged FoodFoodCopy logged food from a particular day, optionally filtering by meal type, to another day.

Source Date
The source date of the food entries to copy. Defaults to Yesterday.

Destination Date
The destination date of the food entries to copy. Defaults to Today.

Meal Type
The meal type to filter by when copying food entries.

Confirm Before Copying
Whether or not to copy the food entries without confirmation. Defaults to true.
Delete Logged FoodFoodDeletes food entries from your food log.

Delete Immediately
Whether or not to delete food entries without confirmation.
Duplicate FoodFoodDuplicates a food, allowing you to make changes without impacting the original.

Immediately Save
Whether to save the duplicated food to your food library, or pass it as output.
Edit FoodFoodModifies a specific field of a food.

Food
The field to edit.
Find FoodFoodFinds or filters food items. Note: By default, this action returns food items from your library. To use food you have previously logged, first run the Get Logged Food action, then pass its output into this action.

Sort By
Optionally, what to sort the food by.

Limit
Whether or not to limit the number of food retrieved.

Get
The maximum number of food to limit by.

Result
The food that matches the criteria.
Get DrinksFoodRetrieves the list of preset drinks from Foodnoms. Allows you to select All Drinks, one, or multiple drinks to pass out as a result.
Get Logged FoodFoodRetrieves logged food from a particular day.

Date
The date of the food entries to get. Options include presets for Yesterday, Today, On Date, This Week Last Week, and Between Dates.

Meal Type
The type of meal to get logged food from. Options include Any Meal Type, Current Meal Type, Other, and the Meal Types specified in Settings > Meal Types.
Get Smart SuggestionsFoodGets smart suggestions for a particular day and meal type. Note: Smart Suggestions are determined by a mix of of factors, including which day of week and food logged on that same day of the week. For example, when run on a Monday, gets smart suggestions for food logged on Mondays.

Meal Type
The meal type to get smart suggestions for. Options include Current Meal Type and the Meal Types specified in Settings > Meal Types.
Open FoodFoodOpens a food item in the app to the Edit Food view, where you can view the item summary, plus manually change item details, adjust Nutrients values, and share or delete the food.

Food
The food to open.
Scan BarcodeFoodScans a barcode from an image passed as input, then looks up the result in your library and the Foodnoms Database.

Image
The image with the barcode to be scanned.

Result
(Food) Food from your library or the Foodnoms Database that matches the scanned barcode. Note: If no results are found, action passes nothing as output.
Search Foodnoms DatabaseFoodReturns a list of food using a query for any food or brand.

Text
The text to search for.

Scope
Whether to search for generic foods, branded foods, or both.

Limit
The maximum amount of results to be returned. Must be less than or equal to 30. Note: You can increase the limit up to 30, but repeated use may result in rate limiting.
Add New GoalGoalsCreates a goal to track your progress over time. Includes options to specify a goal type, tracking mode, and detailed parameters based on the selected mode.

Type
The type of goal to create. Options include Calories/Energy, macronutrients, other nutrients, and fasting.

Overwrite If Goal Exists
Whether or not to add the new goal if one already exists of the same type. If toggled off, will error if existing goal is found.
Change GoalGoalsModifies a specific field of a goal. Options include Mode, Adjust Using Active Energy Burned, Relative to Calorie Goal, Resting Energy Calculation, Age, Weight, Height, resting metabolic rate (RMR), sex, active energy, weekly weight goal, daily minimum, and one-day exception.

Goal
The type of goal to modify.

One-Day Exception
Whether or not to have these changes only be in effect for a single day, or from now on.
Check Goal ProgressGoalsSummarizes the specified goal's progress by evaluating logged food against the goal's date, then returns a rich result showing the progress. Note: See the description for Change Goal to see the type of data available for each goal.

Goal
The goal to check.

Show When Run
Whether to show the rich snippet of the goal progress, or to simply pass the goal as a result.
Delete GoalGoalsPermanently delete a goal and removes all history of goal settings. Note: Deleting a goal does not remove consumption records, as amounts consumed are logged separately within your food entries.

Goal
The goal to delete.

Delete Immediately
Whether or not to delete the goal without confirmation. If toggled on, prompts twice to ask if you are really sure.
Find GoalsGoalsRetrieves a list of goals according to the specified criteria.

Find
The goals to find. Defaults to All Goals. When set with the result of another action, changes to Filter.

Add Filter
Optionally, the criteria to filter by. Includes all types of data available for goals. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another.

Sort By
Optionally, what to sort the goals by.

Limit
Whether or not to limit the number of goals retrieved.

Get
The maximum number of goals to limit by.

Result
The goals that matches the criteria.
Get Goal TypesGoalsGets a list of the types of goals available to set. Retrieves all, one, or multiple types of possible goals.

Goal Type
The type of goal to get, whether All Goal Types or a specific goal type.

Type
If set to Goal Type, the specific goal type to get.
Get GoalsGoalsGets a list of your goals that have already been set. Retrieves all, one, or multiple types of your set goals.

Goal Type
The type of your goal to get, whether All Goals, or a specific Goal.

Type
If set to Goal, the specific goal type to get.

Date
The date to get the goal from. Options include Today, Yesterday, and On Date, where you can specify a date.
Open GoalGoalsOpens a goal in the app, where you can check visualizations for how much you've consumed against your goal amount across various periods.

Goal
The goal to open.
Get Library ItemsLibraryGets a list of items from your food library, Includes the option to select all, one, or multiple items of each type to pass as a result.

Type
The type of item to get. Options include All Food, All Recipes, All Meals, or a specific food, recipe, or meal.

Item
If set to Food, Recipe, or Meal, the specific food, recipe, or meal to get. Note: Both Meals and Recipes contain a Food parameter, which means they can used with Food actions.
Save To LibraryLibrarySaves a food, recipe, or meal to your library as an item.

Type
The type of item to save, whether it's Food, Recipe, or Meal.

Overwrite If Item with Same Name Exists
Whether or not to overwrite the item if another item exists in your library with the same name. Defaults to off, which means it will create a duplicate item (rather than destroying your existing item).
Search Food LibraryLibraryReturns a list of food, recipes, and meals that match a query.

Text
The text to search for.

Scope
Whether to search for food, recipes, meals, or All content in your library.

Open When Run
Whether or not to open to search results for your query in the app, or return a list of results
Ask Foodnoms AILogSubmits a query to FoodNoms AI, which returns a list of food items based on your input. Includes the ability to add text, an image, or both. Note: Foodnoms AI usage is rate limited.

Text
A natural-language description of the food items to log.

Image
A photo of the food items to log.

Mode
The mode to use when querying Foodnoms AI. Options include Estimate Mode and Database Mode.

Date
The date and time of the food entry to create.

Meal Type
The meal type associated with the food entry. Options include Current Meal Type and Meal Types specified in Foodnoms > Settings > Meal Types.

Accuracy
The estimate for the accuracy of nutrients for this food entry. Options include Accurate, Approximate, and estimate.

Log Immediately
Whether to log the generated items immediately, or simply pass them as a result.
LogLogLogs a food, recipe, meal, favorite, or drink as a food entry in your Food Log.

Type
The type of item to log, whether Food, Recipe, Meal, Favorite, or Drink.

Food/Recipe/Meal/Favorite/Drink
For a specified Type, the item to log.

Date
The date and time for the food entry.

Time
Whether or not to log with time.

Meal Type
The meal type for the food entry. Defaults to Current Meal Type, which uses the corresponding meal type as defined in Settings > Meal Type.

Use Last Portion Size
Whether to use the portion size from the most recent entry for this item. If no previous entry exists, the default portion size is used.

Quantity
The amount of food consumed, as expressed in the specified Unit.

Unit
The measurement unit for the food entry.

Accuracy
The estimated for the accuracy of nutrients for the food entry. Options include Accurate (+/- 0%), Approximate (+/- 10%) and Estimate (+/- 30%).
Log Quick EntryLogCreates a quick entry that logs nutritional amounts consumed, without an existing food item.

Name
The name of the quick entry. Defaults to "Quick Entry" if none is given.

Date
The date and time of the entry.

Meal Type
The meal type associated with the entry.

Accuracy
The estimate for the accuracy of nutrients for this food entry. Options include Accurate, Approximate, and estimate.
Open Foodnoms AILogOpens the FoodNoms AI view, which can be used to submit a query and log the generated food items. Includes the ability to pass text, an image, or both as input, as well as specify the mode, all of which are activated when Foodnoms AI is opened.

Text
A natural-language description of the food items to log.

Image
A photo of the food items to log.

Mode
The mode to use when querying Foodnoms AI. Options include Estimate Mode and Database Mode.
Open Log Food ScreenLogOpens to the Log Food screen, the main menu for logging, letting you manually create an entry using the Foodnoms interface for Search, Favorites, Smart Suggestions, and options for Create, Library, Scan, Drinks, and AI.
Open ScannerLogOpens the Barcode Scanner or the Foodnoms AI scanner, letting you quickly create an entry for food using your device's camera.

Scanner
The type of scanner to open. Options include Barcode Scanner and Foodnoms AI Scanner.
Find Meal TypesMeal TypesRetrieves a list of meals types, as specified in Foodnoms' Settings under Meal Types.

Sort By
Optionally, what to sort the meal types by.

Limit
Whether or not to limit the number of meal types retrieved.

Get
The maximum number of meal types to limit by.

Result
The meal types that match the criteria.
Get Meal TypesMeal TypesRetrieves available Meal Types, as specified in Foodnoms' Settings under Meal Types. Includes options to select all, one, or multiple meal types.

Result
(Meal Types) The specified meal types.
Create MealMealsCreates a new meal using the food passed as input.

Name
The name of the new meal.

Food
The food items that make up the meal.

Immediately Save
Whether to save the created meal to your food library, or pass it as output.
Duplicate MealMealsDuplicates a meal, allowing you to make changes without impacting the original.

Immediately Save
Whether to save the duplicated meal to your food library, or pass it as a result.
Edit MealMealsModifies a specific field of a meal.

Meal
The meal to edit.

Detail
The specific field of the meal to be modified. Options include Name and Food.

Value
The value of the specific field to be modified. Value changes according to the type of field.
Find MealMealsRetrieves a list of meals from your food library according to the specified criteria.

Find
The meals to find. Defaults to All Meals. When set with the result of another action, changes to Filter.

Add Filter
Optionally, the criteria to filter by. Includes all types of data available for meals. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another.

Sort By
Optionally, what to sort the meals by.

Limit
Whether or not to limit the number of meals retrieved.

Get
The maximum number of meals to limit by.
Open MealMealsOpens a meal in the app to the Edit Meal view, where you can view the summary of food items in the meal, plus manually change the meal name, add or remove food items, and share or delete the food.

Meal
The meal to open.
Create RecipeRecipesCreates a new recipe using the ingredients passed as input.

Name
The name of the new meal.

Food
The ingredients that are used to make the recipe.

Number of Servings
How many servings the recipe makes.

Total Weight (g)
The total mass of the prepared food, expressed as grams.

Immediately Save
Whether to save the created meal to your food library, or pass it as a result.
Duplicate RecipeRecipesDuplicates a recipe, allowing you to make changes without impacting the original.

Immediately Save
Whether to save the duplicated recipe to your food library, or pass it as a result.
Edit RecipeRecipesModifies a specific field of a recipe.

Recipe
The meal to edit.

Detail
The specific field of the recipe to be modified. Options include Name, Food, Number of Servings, Total Wight (g), URL, and Notes.

Value
The value of the specific field to be modified. Value changes according to the type of field.
Find RecipesRecipesRetrieves a list of recipes from your food library according to the specified criteria.

Find
The recipes to find. Defaults to All Recipes. When set with the result of another action, changes to Filter.

Add Filter
Optionally, the criteria to filter by. Includes all types of data available for recipes. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another.

Sort By
Optionally, what to sort the recipes by.

Limit
Whether or not to limit the number of recipes retrieved.

Get
The maximum number of recipes to limit by.
Open RecipeRecipesOpens a recipe in the app to the Edit Recipe view, where you can view the recipe summary and ingredients in the recipe, manually change the recipe name, number of servings, and total weight, add or remove ingredients, update the URL and notes, and share or delete the food.

Recipe
The recipe to open.