# Fatsecret MCP

> Fatsecret MCP is an open-source MCP server for food and drink. Self-hosted MCP server for drafting and logging meals to a FatSecret food diary. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Repository:** https://github.com/jaronskijakub/fatsecret-mcp
- **MCP Registry name:** io.github.jaronskijakub/fatsecret-mcp
- **Categories:** [food and drink](https://ai-powered.com/categories/food-and-drink), [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

Nothing is written to the diary until you approve it. Claude proposes a draft with amounts, calories, macros, a suggested meal and how your day looks after adding it, and confirm_draft saves only what you said yes to. Drafts are signed by the server, expire after thirty minutes and can only be confirmed by the person they were made for.

The README lists five tools: search_foods, draft_entries, confirm_draft, get_diary_day and get_period_summary. Meals can be described in words or photographed, and a nutrition-label photo covers packaged products missing from the catalog. A free FatSecret API key only reaches the US catalog in English, so for such products the server logs the closest catalog food scaled to match the label's calories; the macros are only close, and the draft shows the difference.

There is no public instance. One server can serve a household, each person with their own FatSecret account. The project is unofficial and not medical or dietary advice.

## Features

- **Draft before saving:** Entries are proposed first and written only after you confirm.
- **Photo and label logging:** A dinner photo or a nutrition-label photo can drive an entry.
- **Day and period summaries:** Reads a day against your targets, or up to 31 days of totals.
- **Repeat earlier meals:** Copies a past meal from your diary and scales amounts you change.
- **Edit or remove entries:** Fixes or deletes existing entries through the same draft step.
- **Household support:** One server holds several users, each with their own FatSecret login.

## Good for

- Log lunch from a photo while on your phone
- Check how many calories and macros are left today
- Compare this week's averages with last week's
- Repeat yesterday's breakfast with an ingredient removed
- Correct a wrongly logged amount

## Install

### Claude Code (Terminal)

```sh
claude mcp add fatsecret-mcp --env FATSECRET_CONSUMER_KEY='<FATSECRET_CONSUMER_KEY>' --env FATSECRET_CONSUMER_SECRET='<FATSECRET_CONSUMER_SECRET>' --env FATSECRET_MCP_SIGNING_KEY='<FATSECRET_MCP_SIGNING_KEY>' --env FATSECRET_MCP_USERS='<FATSECRET_MCP_USERS>' -- uvx fatsecret-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fatsecret-mcp": {
      "command": "uvx",
      "args": [
        "fatsecret-mcp"
      ],
      "env": {
        "FATSECRET_CONSUMER_KEY": "<FATSECRET_CONSUMER_KEY>",
        "FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>",
        "FATSECRET_MCP_SIGNING_KEY": "<FATSECRET_MCP_SIGNING_KEY>",
        "FATSECRET_MCP_USERS": "<FATSECRET_MCP_USERS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fatsecret-mcp": {
      "command": "uvx",
      "args": [
        "fatsecret-mcp"
      ],
      "env": {
        "FATSECRET_CONSUMER_KEY": "<FATSECRET_CONSUMER_KEY>",
        "FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>",
        "FATSECRET_MCP_SIGNING_KEY": "<FATSECRET_MCP_SIGNING_KEY>",
        "FATSECRET_MCP_USERS": "<FATSECRET_MCP_USERS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fatsecret-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fatsecret-mcp"
      ],
      "env": {
        "FATSECRET_CONSUMER_KEY": "<FATSECRET_CONSUMER_KEY>",
        "FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>",
        "FATSECRET_MCP_SIGNING_KEY": "<FATSECRET_MCP_SIGNING_KEY>",
        "FATSECRET_MCP_USERS": "<FATSECRET_MCP_USERS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fatsecret-mcp": {
      "command": "uvx",
      "args": [
        "fatsecret-mcp"
      ],
      "env": {
        "FATSECRET_CONSUMER_KEY": "<FATSECRET_CONSUMER_KEY>",
        "FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>",
        "FATSECRET_MCP_SIGNING_KEY": "<FATSECRET_MCP_SIGNING_KEY>",
        "FATSECRET_MCP_USERS": "<FATSECRET_MCP_USERS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fatsecret-mcp": {
      "command": "uvx",
      "args": [
        "fatsecret-mcp"
      ],
      "env": {
        "FATSECRET_CONSUMER_KEY": "<FATSECRET_CONSUMER_KEY>",
        "FATSECRET_CONSUMER_SECRET": "<FATSECRET_CONSUMER_SECRET>",
        "FATSECRET_MCP_SIGNING_KEY": "<FATSECRET_MCP_SIGNING_KEY>",
        "FATSECRET_MCP_USERS": "<FATSECRET_MCP_USERS>"
      }
    }
  }
}
```

## Tools

- `search_foods`: Finds foods in the FatSecret catalog with loggable servings
- `draft_entries`: Proposes diary entries without writing anything
- `confirm_draft`: Writes the draft you approved
- `get_diary_day`: Reads one day with totals and remaining targets
- `get_period_summary`: Reads daily totals for up to 31 days

## FAQ

### Is it official?

No. The README says it is unofficial and not affiliated with FatSecret, Anthropic or OpenAI.

### Is there a hosted instance?

No. You run your own server.

### What credentials does it need?

A FatSecret Platform API consumer key and secret, a signing key of at least 32 characters, and a user list created with fatsecret-mcp add-user.

### Are macros exact for products outside the catalog?

Calories match the label but macros are approximate, because a free key cannot create foods.

### Is Fatsecret MCP free?

Yes. Fatsecret MCP is open source, so you can use and self-host it for free.

### How do I add Fatsecret MCP to Claude Code?

Run this command in your terminal: claude mcp add fatsecret-mcp --env FATSECRET_CONSUMER_KEY='<FATSECRET_CONSUMER_KEY>' --env FATSECRET_CONSUMER_SECRET='<FATSECRET_CONSUMER_SECRET>' --env FATSECRET_MCP_SIGNING_KEY='<FATSECRET_MCP_SIGNING_KEY>' --env FATSECRET_MCP_USERS='<FATSECRET_MCP_USERS>' -- uvx fatsecret-mcp

### What are the best alternatives to Fatsecret MCP?

The closest alternatives to Fatsecret MCP are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [BasalFit](https://ai-powered.com/mcp/basalfit): BasalFit is a free MCP server for health and science.
- [Ebi Ols](https://ai-powered.com/mcp/ebi-ols): Ebi Ols is a freemium MCP server for health and science.
- [Clinicaltables](https://ai-powered.com/mcp/clinicaltables): Clinicaltables is a freemium MCP server for health and science.
- [Complex Portal](https://ai-powered.com/mcp/complex-portal): Complex Portal is a freemium MCP server for health and science.
- [Reaction Time Test MCP](https://ai-powered.com/mcp/reaction-time-test-mcp): Reaction Time Test MCP is a free MCP server for games and play.
- [Zovo Trial Finder](https://ai-powered.com/mcp/zovo-trial-finder): Zovo Trial Finder is an MCP server for health and science.

---
Source: https://ai-powered.com/mcp/fatsecret-mcp-2
