Fatsecret Mcp

io.github.flipthewebPublished by GitHub account flipthewebv0.0.10Updated Nov 1, 2026

MCP server for FatSecret API - food search, nutrition, diary, recipes, weight tracking (unofficial)

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

Unofficial FatSecret MCP server that lets an assistant search foods and recipes, read nutrition data, and manage a FatSecret food diary, weight and exercise…

What you can do
  • Search foods, look up details and barcodes, autocomplete, and browse categories, sub-categories, brands and recipe types
  • Search recipes and read recipe details with ingredients, directions and nutrition
  • Read, add, edit, delete and copy food diary entries, and get monthly calorie and macro summaries
  • Manage saved meals and their items, and favorite foods and recipes
  • Record weight and view monthly weight history
  • List exercise types, shift exercise time, view monthly exercise calories, save exercise templates, and read the profile
When to use it
Useful when you want an assistant to look up nutrition facts, plan or log meals, and keep a FatSecret diary, weight and exercise record in one conversation instead of switching to the FatSecret app or site.
Requirements
Runs locally via npx with Node.js 18 or later. Needs a free FatSecret Platform API account and three credentials: FATSECRET_CLIENT_ID, FATSECRET_CLIENT_SECRET and FATSECRET_CONSUMER_SECRET, given as environment variables or saved through the setup tool. Profile tools also need OAuth 1.0 authorization of the user's FatSecret account via a browser PIN flow. Some tools are limited to FatSecret Premier plans.
Before you install
Requires API secrets (FATSECRET_CLIENT_ID, FATSECRET_CLIENT_SECRET, FATSECRET_CONSUMER_SECRET); the setup tool writes them, along with OAuth tokens, to a config file in the home directory, while the desktop extension stores them in the OS keychain. Profile tools write, change and delete diary entries, saved meals, favorites, weight and exercise data on the real FatSecret account. Several tools are Premier-only. It is not an official FatSecret server.

Installation

In SourceWeft

  1. Open Fatsecret Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

FatSecret MCP Server [FatSecret Logo]

[!IMPORTANT] This is not an official MCP server by FatSecret. It uses the FatSecret Platform API which requires a free developer account.

An MCP (Model Context Protocol) server that connects Claude/Cursor to the FatSecret Platform API. Search foods, track your diet, manage recipes, and monitor weight directly from your AI assistant.

Available on NPM: npx fatsecret-mcp | Claude Desktop Extension: fatsecret-mcp.mcpb

✨ Features

  • 🔐 Authentication — Interactive credential setup and OAuth authorization
  • 🔍 Food Search — Search FatSecret's extensive food database with detailed nutrition data
  • 📷 Barcode Lookup — Find foods by GTIN-13 barcode
  • 🍳 Recipe Search — Browse and filter recipes by calories, macros, and prep time
  • 📝 Food Diary — Add, edit, copy, and delete food diary entries
  • 🍽️ Saved Meals — Create and manage reusable meal templates
  • ⚖️ Weight Tracking — Record and view weight history
  • 🏃‍♂️ Exercise Tracking — View exercises and manage activity entries
  • ⭐ Favorites — Manage favorite foods and recipes

🚀 Quick Start

Add to your MCP client configuration:

json
{  "mcpServers": {    "fatsecret": {      "command": "npx",      "args": ["-y", "fatsecret-mcp"]    }  }}

That's it! On first use, the AI will guide you through setup:

  1. check_auth_status — detects missing credentials and tells you what to do
  2. setup_credentials — you provide your API keys (saved to ~/.fatsecret-mcp/config.json)
  3. start_auth → complete_auth — authorize your FatSecret account for diary/weight tools

Alternatively, you can pass credentials as environment variables:

json
{  "mcpServers": {    "fatsecret": {      "command": "npx",      "args": ["-y", "fatsecret-mcp"],      "env": {        "FATSECRET_CLIENT_ID": "your_client_id",        "FATSECRET_CLIENT_SECRET": "your_client_secret",        "FATSECRET_CONSUMER_SECRET": "your_consumer_secret"      }    }  }}

🔑 Where to Get Credentials

  1. Create a free account at platform.fatsecret.com
  2. Navigate to My Account → API Keys
  3. You'll see three values:
    • Client ID (used for both OAuth 2.0 and OAuth 1.0)
    • Client Secret (OAuth 2.0 - for public food/recipe search)
    • Consumer Secret (OAuth 1.0 - for user profile/diary access)

📖 Step-by-step guide: Getting Started with FatSecret API

Claude Desktop (Extension)

Download and open fatsecret-mcp.mcpb with Claude Desktop. You'll be prompted to enter your FatSecret credentials — secrets are stored securely in the OS keychain.

[!WARNING] If one-click install fails or the extension doesn't start, it may be a Claude Desktop bug (mcpb#281). Workaround: download fatsecret-mcp.zip, extract it, and use Settings → Extensions → Advanced settings → Install Unpacked Extension. Or use the npx config above.

See Building Desktop Extensions with MCPB for more details.

Claude Desktop (Manual)

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code (CLI)

bash
claude mcp add fatsecret -- npx -y fatsecret-mcp

Or with env vars:

bash
claude mcp add fatsecret \  -e FATSECRET_CLIENT_ID=your_client_id \  -e FATSECRET_CLIENT_SECRET=your_client_secret \  -e FATSECRET_CONSUMER_SECRET=your_consumer_secret \  -- npx -y fatsecret-mcp

Verify with claude mcp list.

Cursor

  • Settings UI — Settings → MCP → + Add new MCP server, then fill in the command, args, and env
  • Project config — add JSON to .cursor/mcp.json in your project root
  • Global config — add JSON to ~/.cursor/mcp.json

🛠️ Available Tools

ToolDescription
🔐 Setup & Auth
check_auth_statusCheck if credentials and profile auth are configured. Call this first.
setup_credentialsSave FatSecret API credentials to persistent config
start_authStart OAuth 1.0 authorization — returns URL for user to visit
complete_authComplete OAuth with verifier PIN from authorization page
🔍 Food Search (public)
search_foodsSearch the food database
get_foodGet detailed nutrition info for a food
find_food_by_barcodeFind food by GTIN-13 barcode
autocomplete_foodsGet search autocomplete suggestions
🍳 Recipes (public)
search_recipesSearch recipes with filters
get_recipeGet recipe details with ingredients and directions
📚 Reference (public)
get_food_categoriesGet food categories
get_food_sub_categoriesGet food sub categories
get_brandsGet food brands
get_recipe_typesGet recipe types
📝 Food Diary (profile auth)
get_food_entriesGet food diary entries for a date
get_food_entries_monthGet monthly nutrition summary (calories & macros per day)
create_food_entryAdd a food diary entry
edit_food_entryEdit a food diary entry
delete_food_entryDelete a food diary entry
copy_food_entriesCopy entries from one date to another
copy_saved_meal_entriesCopy a saved meal to a date
⭐ Favorites (profile auth)
get_favorite_foodsGet favorite foods
delete_favorite_foodRemove food from favorites
get_most_eaten_foodsGet most eaten foods
get_recently_eaten_foodsGet recently eaten foods
get_favorite_recipesGet favorite recipes
add_favorite_recipeAdd recipe to favorites
delete_favorite_recipeRemove recipe from favorites
🍽️ Saved Meals (profile auth)
get_saved_mealsGet saved meals
create_saved_mealCreate a saved meal
edit_saved_mealEdit a saved meal
delete_saved_mealDelete a saved meal
get_saved_meal_itemsGet items in a saved meal
add_saved_meal_itemAdd food to a saved meal
edit_saved_meal_itemEdit saved meal item
delete_saved_meal_itemRemove item from saved meal
⚖️ Weight (profile auth)
update_weightRecord weight for a date
get_weight_monthGet weight history for a month
🏃‍♂️ Exercise (profile auth)
get_exercisesGet exercise types
edit_exercise_entriesShift exercise time between activities
get_exercise_entries_monthGet exercise data for a month
save_exercise_templateSave exercise template for weekdays
👤 Profile (profile auth)
get_profileGet user profile info
create_foodCreate a custom food (Premier)

API reference: FatSecret Postman Collection

🧪 Test Connection

bash
npx fatsecret-mcp

Or with env vars:

bash
FATSECRET_CLIENT_ID='...' FATSECRET_CLIENT_SECRET='...' FATSECRET_CONSUMER_SECRET='...' npx fatsecret-mcp

📋 Requirements

  • Node.js 18+
  • FatSecret Platform API account (platform.fatsecret.com)
  • MCP-compatible client (Claude Desktop, Cursor, etc.)

🔧 Development

  1. Clone the repository
  2. npm install
  3. Copy .env.example to .env and fill in your credentials
  4. npm run dev to run in development mode

Debugging with MCP Inspector:

bash
FATSECRET_CLIENT_ID=X FATSECRET_CLIENT_SECRET=X FATSECRET_CONSUMER_SECRET=X npx -y @modelcontextprotocol/inspector npx <local-path>/fatsecret-mcp

📄 License

MIT License - see LICENSE file for details.

Source: README.md at commit 0de2bef

Tools

44

search_foods

Search the FatSecret food database. Returns food names, descriptions, and basic nutrition info. On the Basic plan only search_expression, page_number and max_results (max 50) are used.

Parametersregionlanguagefood_typemax_resultspage_numbersearch_expressionrequiredinclude_food_imagesflag_default_servinginclude_sub_categoriesinclude_food_attributes

get_food

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

Parametersregionfood_idrequiredlanguagepage_numberinclude_food_imagesflag_default_servinginclude_sub_categoriesinclude_food_attributes

find_food_by_barcode

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

Parametersregionbarcoderequiredlanguageinclude_food_imagesflag_default_servinginclude_sub_categoriesinclude_food_attributes

autocomplete_foods

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

Parametersregionlanguageexpressionrequiredmax_results

search_recipes

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

Parameterssort_bycalories.tomax_resultspage_numberprep_time.torecipe_typescalories.fromprep_time.frommust_have_imagesfat_percentage.tosearch_expressioncarb_percentage.to+5 more

get_recipe

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

Parametersrecipe_idrequiredmax_resultspage_number

get_food_categories

Get the full list of food categories. Premier exclusive.

Parametersregionlanguage

get_food_sub_categories

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

Parametersregionlanguagefood_category_idrequired

get_brands

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

Parametersregionlanguagebrand_typestarts_with

get_recipe_types

Get the full list of supported recipe type names.

Takes no parameters.

get_food_entries

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

Parametersdatefood_entry_id

get_food_entries_month

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

Parametersdate

create_food_entry

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

Parametersdatemealrequiredfood_idrequiredserving_idrequiredfood_entry_namerequirednumber_of_unitsrequired

edit_food_entry

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

Parametersmealserving_idfood_entry_idrequiredfood_entry_namenumber_of_units

delete_food_entry

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

Parametersfood_entry_idrequired

copy_food_entries

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

Parametersmealto_daterequiredfrom_daterequired

copy_saved_meal_entries

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

Parametersdatemealrequiredsaved_meal_idrequired

get_favorite_foods

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

Takes no parameters.

delete_favorite_food

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

Parametersfood_idrequiredserving_idnumber_of_units

get_most_eaten_foods

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

Parametersmeal

get_recently_eaten_foods

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

Parametersmeal

get_favorite_recipes

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

Takes no parameters.

add_favorite_recipe

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

Parametersrecipe_idrequired

delete_favorite_recipe

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

Parametersrecipe_idrequired

get_saved_meals

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

Parametersmeal

create_saved_meal

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

Parametersmealssaved_meal_namerequiredsaved_meal_description

edit_saved_meal

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

Parametersmealssaved_meal_idrequiredsaved_meal_namesaved_meal_description

delete_saved_meal

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

Parameterssaved_meal_idrequired

get_saved_meal_items

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

Parameterssaved_meal_idrequired

add_saved_meal_item

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

Parametersfood_idrequiredserving_idrequiredsaved_meal_idrequirednumber_of_unitsrequiredsaved_meal_item_namerequired

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).

Parametersnumber_of_unitssaved_meal_item_idrequiredsaved_meal_item_name

delete_saved_meal_item

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

Parameterssaved_meal_item_idrequired

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).

Parametersdatecommentheight_typeweight_typegoal_weight_kgcurrent_height_cmcurrent_weight_kgrequired

get_weight_month

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

Parametersdate

get_exercises

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

Takes no parameters.

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).

Parametersdatekcalminutesrequiredshift_to_idrequiredshift_from_idrequiredshift_to_nameshift_from_name

get_exercise_entries_month

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

Parametersdate

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).

Parametersdatedaysrequired

get_profile

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

Takes no parameters.

create_food

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

Parametersfatrequiredironfibersugarsodiumcalciumproteinrequiredcaloriesrequiredfood_namerequiredpotassiumtrans_fatvitamin_a+13 more

check_auth_status

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

Takes no parameters.

setup_credentials

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

Parametersclient_idrequiredclient_secretrequiredconsumer_secretrequired

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).

Takes no parameters.

complete_auth

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

Parametersverifierrequired

Version history

2
  1. v0.0.10LatestNov 1, 2026
  2. v0.0.8Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts