FatSecret MCP Server

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)

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

API reference: FatSecret Postman Collection

🧪 Test Connection

npx fatsecret-mcp

Or 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

1. Clone the repository

2. npm install

3. Copy .env.example to .env and fill in your credentials

4. npm run dev to 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.