FatSecret MCP Server 
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:
{
"mcpServers": {
"fatsecret": {
"command": "npx",
"args": ["-y", "fatsecret-mcp"]
}
}
}
That's it! On first use, the AI will guide you through setup:
check_auth_status — detects missing credentials and tells you what to dosetup_credentials — you provide your API keys (saved to ~/.fatsecret-mcp/config.json)start_auth → complete_auth — authorize your FatSecret account for diary/weight tools
Alternatively, you can pass credentials as environment variables:
{
"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
- Create a free account at platform.fatsecret.com
- Navigate to My Account → API Keys
- 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.
See Building Desktop Extensions with MCPB for more details.
Claude Desktop (Manual)
~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code (CLI)
claude mcp add fatsecret -- npx -y fatsecret-mcp
Or with env vars:
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
| Tool | Description |
|---|
| 🔐 Setup & Auth | |
check_auth_status | Check if credentials and profile auth are configured. Call this first. |
setup_credentials | Save FatSecret API credentials to persistent config |
start_auth | Start OAuth 1.0 authorization — returns URL for user to visit |
complete_auth | Complete OAuth with verifier PIN from authorization page |
| |
| 🔍 Food Search (public) | |
search_foods | Search the food database |
get_food | Get detailed nutrition info for a food |
find_food_by_barcode | Find food by GTIN-13 barcode |
autocomplete_foods | Get search autocomplete suggestions |
| |
| 🍳 Recipes (public) | |
search_recipes | Search recipes with filters |
get_recipe | Get recipe details with ingredients and directions |
| |
| 📚 Reference (public) | |
get_food_categories | Get food categories |
get_food_sub_categories | Get food sub categories |
get_brands | Get food brands |
get_recipe_types | Get recipe types |
| |
| 📝 Food Diary (profile auth) | |
get_food_entries | Get food diary entries for a date |
get_food_entries_month | Get monthly nutrition summary (calories & macros per day) |
create_food_entry | Add a food diary entry |
edit_food_entry | Edit a food diary entry |
delete_food_entry | Delete a food diary entry |
copy_food_entries | Copy entries from one date to another |
copy_saved_meal_entries | Copy a saved meal to a date |
| |
| ⭐ Favorites (profile auth) | |
get_favorite_foods | Get favorite foods |
delete_favorite_food | Remove food from favorites |
get_most_eaten_foods | Get most eaten foods |
get_recently_eaten_foods | Get recently eaten foods |
get_favorite_recipes | Get favorite recipes |
add_favorite_recipe | Add recipe to favorites |
delete_favorite_recipe | Remove recipe from favorites |
| |
| 🍽️ Saved Meals (profile auth) | |
get_saved_meals | Get saved meals |
create_saved_meal | Create a saved meal |
edit_saved_meal | Edit a saved meal |
delete_saved_meal | Delete a saved meal |
get_saved_meal_items | Get items in a saved meal |
add_saved_meal_item | Add food to a saved meal |
edit_saved_meal_item | Edit saved meal item |
delete_saved_meal_item | Remove item from saved meal |
| |
| ⚖️ Weight (profile auth) | |
update_weight | Record weight for a date |
get_weight_month | Get weight history for a month |
| |
| 🏃♂️ Exercise (profile auth) | |
get_exercises | Get exercise types |
edit_exercise_entries | Shift exercise time between activities |
get_exercise_entries_month | Get exercise data for a month |
save_exercise_template | Save exercise template for weekdays |
| |
| 👤 Profile (profile auth) | |
get_profile | Get user profile info |
create_food | Create a custom food (Premier) |
API reference: FatSecret Postman Collection
🧪 Test Connection
Or with env vars:
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
- Clone the repository
npm install- Copy
.env.example to .env and fill in your credentials
npm run dev to run in development mode
Debugging with MCP Inspector:
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.