fatsecret
by f-liva
Browser & AutomationBrief
FatSecret nutrition API integration for food search, nutritional lookup, barcode scanning, recipe search, and food.
Description
What This Skill Does
Connects to the FatSecret API for food search, nutritional data lookup, barcode scanning, recipe search, and meal diary logging. Supports two authentication modes: OAuth2 for read-only food queries and OAuth1 for full diary access. Also includes an Open Food Facts client for European product coverage without authentication.
Combines read-only food search and authenticated diary logging in one skill, so you don't need separate tools for lookup versus tracking.
When to Use It
- Looking up calories and macros for a meal
- Scanning a product barcode to get nutrition facts
- Logging breakfast, lunch, and dinner entries to a FatSecret diary
- Searching for recipes that match dietary goals
- Checking micronutrient data for a specific food item
Example Workflow
User asks: log 156 grams of cookies to my breakfast diary
- 1
Check authentication status via get_authentication_flow()
- 2
If OAuth1 tokens are missing, prompt user to visit authorization URL and enter PIN
- 3
Complete authentication with complete_authentication_flow(pin)
- 4
Search for the food with search_food('cookies') to get food_id and serving_id
- 5
Call log_food(food_id, serving_100g_id, 156, 'Breakfast', 'Cookies') to record the entry
156g of cookies logged to the user's FatSecret breakfast diary with correct calorie count
Requirements
- FATSECRET_CONSUMER_KEY — FatSecret API Consumer Key from platform.fatsecret.com
- FATSECRET_CONSUMER_SECRET — FatSecret API Consumer Secret from platform.fatsecret.com
- FatSecret account (required for diary logging via OAuth1)
Installation
clawhub install f-liva/fatsecretRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.