FatSecret MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FatSecret MCP Server
This isnot 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
Related MCP server: MyFitnessPal MCP Server
๐ 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.
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)
claude mcp add fatsecret -- npx -y fatsecret-mcpOr 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-mcpVerify with claude mcp list.
Cursor
Settings UI โ
Settings โ MCP โ + Add new MCP server, then fill in the command, args, and envProject config โ add JSON to
.cursor/mcp.jsonin your project rootGlobal config โ add JSON to
~/.cursor/mcp.json
๐ ๏ธ Available Tools
Tool | Description |
๐ Setup & Auth | |
| Check if credentials and profile auth are configured. Call this first. |
| Save FatSecret API credentials to persistent config |
| Start OAuth 1.0 authorization โ returns URL for user to visit |
| Complete OAuth with verifier PIN from authorization page |
๐ Food Search (public) | |
| Search the food database |
| Get detailed nutrition info for a food |
| Find food by GTIN-13 barcode |
| Get search autocomplete suggestions |
๐ณ Recipes (public) | |
| Search recipes with filters |
| Get recipe details with ingredients and directions |
๐ Reference (public) | |
| Get food categories |
| Get food sub categories |
| Get food brands |
| Get recipe types |
๐ Food Diary (profile auth) | |
| Get food diary entries for a date |
| Get monthly nutrition summary (calories & macros per day) |
| Add a food diary entry |
| Edit a food diary entry |
| Delete a food diary entry |
| Copy entries from one date to another |
| Copy a saved meal to a date |
โญ Favorites (profile auth) | |
| Get favorite foods |
| Remove food from favorites |
| Get most eaten foods |
| Get recently eaten foods |
| Get favorite recipes |
| Add recipe to favorites |
| Remove recipe from favorites |
๐ฝ๏ธ Saved Meals (profile auth) | |
| Get saved meals |
| Create a saved meal |
| Edit a saved meal |
| Delete a saved meal |
| Get items in a saved meal |
| Add food to a saved meal |
| Edit saved meal item |
| Remove item from saved meal |
โ๏ธ Weight (profile auth) | |
| Record weight for a date |
| Get weight history for a month |
๐โโ๏ธ Exercise (profile auth) | |
| Get exercise types |
| Shift exercise time between activities |
| Get exercise data for a month |
| Save exercise template for weekdays |
๐ค Profile (profile auth) | |
| Get user profile info |
| Create a custom food (Premier) |
API reference: FatSecret Postman Collection
๐งช Test Connection
npx fatsecret-mcpOr 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 installCopy
.env.exampleto.envand fill in your credentialsnpm run devto 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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
Related MCP Connectors
Food photo recognition, nutrition search, meal logging and glucose prediction for health apps
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Create, personalize and deliver branded workouts and programs from any AI assistant.
Persistent food journal for AI assistants. Log meals, save recipes, plan meals and track nutrition.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read and write MyFitnessPal data, including food diary, exercises, body measurements, nutrition goals, and water intake.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to read and log MyFitnessPal nutrition data, including tracking calories, macros, searching foods, and adding meals through natural conversation.79 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to search recipes, compose nutritionally balanced meals, optimize weekly meal plans based on macro targets for family members, and generate consolidated grocery lists from a personal recipe database.-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with MyFitnessPal data including food diary, exercises, body measurements, nutrition goals, and water intake through natural language.2072MIT