add_favorite_recipe
Add a recipe to the user's favorites. Requires profile auth (check_auth_status first).
LABSCO SUMMARY
check_auth_status is named as the first call for a reason: most of this needs a profile, and part of it needs a Premier tier as well.
The diary, saved meals, favourites, weight and exercise tools all state that they require profile auth, and the vendor puts check_auth_status in front of them to report what is set up before anything fails. A separate line runs through the food side, where find_food_by_barcode, autocomplete_foods, get_food_categories, get_food_sub_categories, get_brands and create_food are each marked Premier exclusive. Two constraints inside the diary are worth knowing before writing against it: edit_food_entry cannot change an entry's date, and edit_saved_meal_item cannot change its serving_id.
What it is
A FatSecret client with 44 tools covering the food and recipe database, a user's food diary, saved meals and favourites, weight and exercise logging, and the credential and OAuth setup every profile tool depends on.
What you get
- Food lookup: search_foods across the database, get_food for servings, calories, macros and micronutrients, find_food_by_barcode for GTIN-13 with UPC-A, EAN-13 and EAN-8 support, and autocomplete_foods for a partial expression.
- Recipes: search_recipes filtered by calories, carb, fat and protein percentages, prep time and recipe types, get_recipe for ingredients, directions and nutrition, and get_recipe_types.
- Catalogue reads: get_food_categories, get_food_sub_categories and get_brands filtered by starting letter and brand type.
- The food diary: get_food_entries by date or entry id, get_food_entries_month for a per-day calorie and macro summary, create_food_entry, edit_food_entry, delete_food_entry, copy_food_entries between dates and copy_saved_meal_entries into a meal.
- Saved meals and favourites: create_saved_meal, edit_saved_meal, delete_saved_meal and get_saved_meal_items with add, edit and delete for its items, plus get_favorite_foods, delete_favorite_food, get_favorite_recipes, add_favorite_recipe, delete_favorite_recipe, get_most_eaten_foods and get_recently_eaten_foods.
- Weight and exercise: update_weight, where the first weigh-in also requires goal_weight_kg and current_height_cm, get_weight_month, get_exercises, edit_exercise_entries for shifting minutes between activities, get_exercise_entries_month, and save_exercise_template for chosen days of the week.
- create_food for a custom food with its full nutrition panel, and get_profile for the authenticated user's profile status.
- Setup as tools: check_auth_status for what is configured, setup_credentials to store API credentials, and start_auth with complete_auth for the OAuth 1.0 flow that grants profile access.
Requirements
FatSecret API credentials stored through setup_credentials, and — for anything touching a user's diary — an authorised profile from the OAuth 1.0 flow in start_auth and complete_auth. find_food_by_barcode, autocomplete_foods, get_food_categories, get_food_sub_categories, get_brands and create_food are marked Premier exclusive.
Setup effort
One command plus credentials — npx fatsecret-mcp, then supply credentials
USE CASES
01
Logging a meal you just ate
The entry needs a food id, a serving id and a meal type, which is why the search and detail reads come first.
02
Setting up access before any of the diary tools will work
Credentials and profile authorisation are two separate steps, and the status read is what tells you which one is missing.
03
Building a meal you eat often and reusing it
A saved meal holds its own item list, and copying it into a date is a single call rather than re-entering each food.
04
Reviewing a month of intake, output and weight together
The three monthly reads line up on the same calendar, which is what makes a month readable as one picture rather than three.
05
Finding a recipe that fits a macro target
Calories, carb, fat and protein percentages and prep time are all filters on the search, so the shortlist arrives already fitting the constraint.
06
Tracking weight against a goal
The first weigh-in has to carry the goal weight and current height, which is what makes every later entry meaningful.
44 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_saved_meal_item
Add a food item to a saved meal. Requires profile auth (check_auth_status first).
autocomplete_foods
Get autocomplete suggestions for a partial food search expression. Premier exclusive.
check_auth_status
Check if API credentials and profile authentication are configured. Call this first to understand what setup is needed.
complete_auth
Complete the OAuth 1.0 flow with the verifier code from the authorization page.
copy_food_entries
Copy food entries from one date to another, optionally filtered by meal. Requires profile auth (check_auth_status first).
copy_saved_meal_entries
Copy entries from a saved meal to a meal on a specific date. Requires profile auth (check_auth_status first).
create_food
Create a custom food with nutrition info. Premier exclusive. Requires profile auth (check_auth_status first).
create_food_entry
Add a food diary entry. Requires food_id, serving_id, and meal type. Requires profile auth (check_auth_status first).
create_saved_meal
Create a new saved meal. Requires profile auth (check_auth_status first).
delete_favorite_food
Remove a food from the user's favorites. Requires profile auth (check_auth_status first).
delete_favorite_recipe
Remove a recipe from the user's favorites. Requires profile auth (check_auth_status first).
delete_food_entry
Delete a food diary entry by ID. Requires profile auth (check_auth_status first).
delete_saved_meal
Delete a saved meal. Requires profile auth (check_auth_status first).
delete_saved_meal_item
Remove a food item from a saved meal. Requires profile auth (check_auth_status first).
edit_exercise_entries
Shift exercise time between activities for a date. Moves minutes from one exercise to another. Requires profile auth (check_auth_status first).
edit_food_entry
Edit an existing food diary entry. Cannot change the date. Requires profile auth (check_auth_status first).
edit_saved_meal
Edit a saved meal name, description, or associated meals. Requires profile auth (check_auth_status first).
edit_saved_meal_item
Edit a food item in a saved meal (name or units). Cannot change serving_id. Requires profile auth (check_auth_status first).
find_food_by_barcode
Find food by barcode (GTIN-13). UPC-A, EAN-13 and EAN-8 supported. Premier exclusive.
get_brands
Get the list of food brands, optionally filtered by starting letter and type. Premier exclusive.
get_exercise_entries_month
Get daily calories expended from exercise for a month. Requires profile auth (check_auth_status first).
get_exercises
Get the full list of supported exercise types and their IDs. Requires profile auth (check_auth_status first).
get_favorite_foods
Get the user's favorite foods. Requires profile auth (check_auth_status first).
get_favorite_recipes
Get the user's favorite recipes. Requires profile auth (check_auth_status first).
get_food
Get detailed nutritional information for a specific food by ID. Returns servings, calories, macros, and micronutrients.
get_food_categories
Get the full list of food categories. Premier exclusive.
get_food_entries
Get food diary entries for a date or a specific entry by ID. Requires profile auth (check_auth_status first).
get_food_entries_month
Get daily nutrition summary for a month. Returns calories and macros per day. Requires profile auth (check_auth_status first).
get_food_sub_categories
Get food sub categories for a given food category. Premier exclusive.
get_most_eaten_foods
Get the user's most eaten foods, optionally filtered by meal. Requires profile auth (check_auth_status first).
get_profile
Get profile status information for the authenticated user. Requires profile auth (check_auth_status first).
get_recently_eaten_foods
Get the user's recently eaten foods, optionally filtered by meal. Requires profile auth (check_auth_status first).
get_recipe
Get detailed recipe information by ID including ingredients, directions, and nutrition.
get_recipe_types
Get the full list of supported recipe type names.
get_saved_meal_items
Get all food items in a saved meal. Requires profile auth (check_auth_status first).
get_saved_meals
Get the user's saved meals, optionally filtered by meal type. Requires profile auth (check_auth_status first).
get_weight_month
Get the user's weight entries for a month. Requires profile auth (check_auth_status first).
save_exercise_template
Save the current day's exercise entries as a template for specified days of the week. Requires profile auth (check_auth_status first).
search_foods
Search the FatSecret food database. Returns food names, descriptions, and basic nutrition info.
search_recipes
Search recipes with optional filters for calories, macros, prep time, and recipe types.
setup_credentials
Configure FatSecret API credentials. Get them at https://platform.fatsecret.com/ → My Account → API Keys. Saves to persistent config file.
start_auth
Start the OAuth 1.0 authorization flow for profile access. Returns an authorization URL the user must visit. Requires API credentials (setup_credentials first).
update_weight
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).
BEFORE YOU INSTALL
What to know first
Tools you get
44 tools when we connected. Diary, favorites, saved-meal, weight, exercise and profile tools fail until you run start_auth and complete_auth. create_food needs a paid FatSecret Premier tier.
Requires
- npx on PATH
- Node.js 18+
- FATSECRET_CLIENT_ID in your environment
- FATSECRET_CLIENT_SECRET in your environment
- FATSECRET_CONSUMER_SECRET in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 44 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx fatsecret-mcpMCP Clients
Claude Desktop — extension
Download fatsecret-mcp.mcpb from the project's latest GitHub release:
CLAUDE DESKTOP — EXTENSION · URL
https://github.com/fliptheweb/fatsecret-mcp/releases/latest/download/fatsecret-mcp.mcpbOpen the file with Claude Desktop and enter your FatSecret credentials when prompted — they are stored in the OS keychain.
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"fatsecret": {
"command": "npx",
"args": [
"-y",
"fatsecret-mcp"
],
"env": {
"FATSECRET_CLIENT_ID": "<YOUR_FATSECRET_CLIENT_ID>",
"FATSECRET_CLIENT_SECRET": "<YOUR_FATSECRET_CLIENT_SECRET>",
"FATSECRET_CONSUMER_SECRET": "<YOUR_FATSECRET_CONSUMER_SECRET>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add fatsecret -- npx -y fatsecret-mcp
