Fatsecret MCP server

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. checkauthstatus — detects missing credentials and tells you what to do
2. setupcredentials** — you provide your API keys (saved to ~/.fatsecret-mcp/config.json)
3. startauth → completeauth — 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)

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/claudedesktopconfig.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

🛠️ Available Tools

Shortened. The full README is on GitHub.