Search the FatSecret food database. Returns food names, descriptions, and basic nutrition info.

Get detailed nutritional information for a specific food by ID. Returns servings, calories, macros, and micronutrients.

Find food by barcode (GTIN-13). UPC-A, EAN-13 and EAN-8 supported. Premier exclusive.

Get autocomplete suggestions for a partial food search expression. Premier exclusive.

Search recipes with optional filters for calories, macros, prep time, and recipe types.

Get detailed recipe information by ID including ingredients, directions, and nutrition.

Get the full list of food categories. Premier exclusive.

Get food sub categories for a given food category. Premier exclusive.

Get the list of food brands, optionally filtered by starting letter and type. Premier exclusive.

Get the full list of supported recipe type names.

Get food diary entries for a date or a specific entry by ID. Requires profile auth (check_auth_status first).

Get daily nutrition summary for a month. Returns calories and macros per day. Requires profile auth (check_auth_status first).

Add a food diary entry. Requires food_id, serving_id, and meal type. Requires profile auth (check_auth_status first).

Edit an existing food diary entry. Cannot change the date. Requires profile auth (check_auth_status first).

Delete a food diary entry by ID. Requires profile auth (check_auth_status first).

Copy food entries from one date to another, optionally filtered by meal. Requires profile auth (check_auth_status first).

Copy entries from a saved meal to a meal on a specific date. Requires profile auth (check_auth_status first).

Get the user's favorite foods. Requires profile auth (check_auth_status first).

Remove a food from the user's favorites. Requires profile auth (check_auth_status first).

Get the user's most eaten foods, optionally filtered by meal. Requires profile auth (check_auth_status first).

Get the user's recently eaten foods, optionally filtered by meal. Requires profile auth (check_auth_status first).

Get the user's favorite recipes. Requires profile auth (check_auth_status first).

Add a recipe to the user's favorites. Requires profile auth (check_auth_status first).

Remove a recipe from the user's favorites. Requires profile auth (check_auth_status first).

Get the user's saved meals, optionally filtered by meal type. Requires profile auth (check_auth_status first).

Create a new saved meal. Requires profile auth (check_auth_status first).

Edit a saved meal name, description, or associated meals. Requires profile auth (check_auth_status first).

Delete a saved meal. Requires profile auth (check_auth_status first).

Get all food items in a saved meal. Requires profile auth (check_auth_status first).

Add a food item to a saved meal. Requires profile auth (check_auth_status first).

Edit a food item in a saved meal (name or units). Cannot change serving_id. Requires profile auth (check_auth_status first).

Remove a food item from a saved meal. Requires profile auth (check_auth_status first).

Record the user's weight for a date. First weigh-in requires goal_weight_kg and current_height_cm. Requires profile auth (check_auth_status first).

Get the user's weight entries for a month. Requires profile auth (check_auth_status first).

Get the full list of supported exercise types and their IDs. Requires profile auth (check_auth_status first).

Shift exercise time between activities for a date. Moves minutes from one exercise to another. Requires profile auth (check_auth_status first).

Get daily calories expended from exercise for a month. Requires profile auth (check_auth_status first).

Save the current day's exercise entries as a template for specified days of the week. Requires profile auth (check_auth_status first).

Get profile status information for the authenticated user. Requires profile auth (check_auth_status first).

Create a custom food with nutrition info. Premier exclusive. Requires profile auth (check_auth_status first).

Check if API credentials and profile authentication are configured. Call this first to understand what setup is needed.

Configure FatSecret API credentials. Get them at https://platform.fatsecret.com/ → My Account → API Keys. Saves to persistent config file.

Start the OAuth 1.0 authorization flow for profile access. Returns an authorization URL the user must visit. Requires API credentials (setup_credentials first).

Complete the OAuth 1.0 flow with the verifier code from the authorization page.