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:

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:

{
  "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)