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:

📖 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 /fatsecret-mcp

📄 License

MIT License - see LICENSE file for details.