Skip to content
MCP server

Fatsecret MCP

Self-hosted MCP server for drafting and logging meals to a FatSecret food diary

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About Fatsecret MCP

Fatsecret MCP is an open-source MCP server for food and drink. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FATSECRET_CONSUMER_KEYYour FatSecret Platform API consumer key.Required
  • FATSECRET_CONSUMER_SECRETYour FatSecret Platform API consumer secret.Required
  • FATSECRET_MCP_SIGNING_KEYA random key of at least 32 characters that signs drafts. Keep it across restarts.Required
  • FATSECRET_MCP_USERSEveryone the server serves, as one JSON line written by `fatsecret-mcp add-user`.Required
  • FATSECRET_MCP_USERWith more than one person in FATSECRET_MCP_USERS: the id the server acts as.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free; needs a FatSecret Platform API key

Fatsecret MCP 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.

How AIPoweredBot checks servers