fatsecret-mcp — Claude Code MCP server: setup
This MCP server connects an AI client to FatSecret for food lookup, recipe search, nutrition data, food diaries, and weight records.
claude mcp add fatsecret-mcp -e FATSECRET_CLIENT_ID=<FATSECRET_CLIENT_ID> -e FATSECRET_CLIENT_SECRET=<FATSECRET_CLIENT_SECRET> -e FATSECRET_CONSUMER_SECRET=<FATSECRET_CONSUMER_SECRET> -- npx -y fatsecret-mcpWhat fatsecret-mcp does
fatsecret-mcp gives an MCP client access to the FatSecret API. An agent can look up foods, read nutrition details, search by GTIN-13 barcode, find recipes, and browse food references. Profile tools cover diary entries, saved meals, favorites, exercise records, weight history, and profile data.
The server runs with npx -y fatsecret-mcp and accepts FATSECRET_CLIENT_ID, FATSECRET_CLIENT_SECRET, and FATSECRET_CONSUMER_SECRET as environment variables. You need a free FatSecret developer account to obtain them. Diary and profile features also require OAuth authorization, so those tools will not work from API keys alone.
What it helps with
- look up nutrition facts for a food
- identify a product from a GTIN-13 barcode
- search recipes with calorie or macro filters
- add and edit food diary entries
- record weight and inspect monthly history
Example prompts for the agent
- Find the nutrition details for the ingredients in this meal.
- Look up this GTIN-13 barcode and add the food to today’s diary.
- Show my weight history for the month and my recent diary foods.
How to install fatsecret-mcp
Platform CLI
claude mcp add fatsecret-mcp -e FATSECRET_CLIENT_ID=<FATSECRET_CLIENT_ID> -e FATSECRET_CLIENT_SECRET=<FATSECRET_CLIENT_SECRET> -e FATSECRET_CONSUMER_SECRET=<FATSECRET_CONSUMER_SECRET> -- npx -y fatsecret-mcpReplace <…> with your own values
Platform CLI
codex mcp add fatsecret-mcp --env FATSECRET_CLIENT_ID=<FATSECRET_CLIENT_ID> --env FATSECRET_CLIENT_SECRET=<FATSECRET_CLIENT_SECRET> --env FATSECRET_CONSUMER_SECRET=<FATSECRET_CONSUMER_SECRET> -- npx -y fatsecret-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"fatsecret-mcp": {
"command": "npx",
"args": [
"-y",
"fatsecret-mcp"
],
"env": {
"FATSECRET_CLIENT_ID": "<FATSECRET_CLIENT_ID>",
"FATSECRET_CLIENT_SECRET": "<FATSECRET_CLIENT_SECRET>",
"FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"fatsecret-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fatsecret-mcp"
],
"env": {
"FATSECRET_CLIENT_ID": "<FATSECRET_CLIENT_ID>",
"FATSECRET_CLIENT_SECRET": "<FATSECRET_CLIENT_SECRET>",
"FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FATSECRET_CLIENT_ID=<FATSECRET_CLIENT_ID> -e FATSECRET_CLIENT_SECRET=<FATSECRET_CLIENT_SECRET> -e FATSECRET_CONSUMER_SECRET=<FATSECRET_CONSUMER_SECRET> fatsecret-mcp npx -y fatsecret-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about fatsecret-mcp
How do I install fatsecret-mcp in Claude Code?
Set the FatSecret credentials as environment variables, then run `claude mcp add fatsecret-mcp -e FATSECRET_CLIENT_ID=<FATSECRET_CLIENT_ID> -e FATSECRET_CLIENT_SECRET=<FATSECRET_CLIENT_SECRET> -e FATSECRET_CONSUMER_SECRET=<FATSECRET_CONSUMER_SECRET> -- npx -y fatsecret-mcp`.
What does fatsecret-mcp do?
It lets an agent use FatSecret for food and recipe searches, nutrition details, food diary changes, saved meals, favorites, exercise records, and weight tracking.
What does fatsecret-mcp need for profile features?
Create a free FatSecret developer account and provide FATSECRET_CLIENT_ID, FATSECRET_CLIENT_SECRET, and FATSECRET_CONSUMER_SECRET. Diary and profile tools also need OAuth authorization.
