npm package: @neonwatty/food-tracker-mcp
Description: MCP server for food tracking and calorie logging using USDA FoodData Central
Author: neonwatty
Latest version: 1.0.0

# Food Tracker MCP Server

A Model Context Protocol (MCP) server for tracking food intake and nutrition using the USDA FoodData Central database.

## Features

- **Search Foods**: Query the USDA FoodData Central database for nutritional information
- **Log Meals**: Record food intake with calories, macros, and serving sizes
- **Track Progress**: View daily logs with totals compared to your goals
- **Set Goals**: Define daily targets for calories, protein, carbs, and fat
- **Get Summaries**: View nutrition averages over days, weeks, or months

## Installation

### Claude Desktop

Add to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "food-tracker": {
      "command": "npx",
      "args": ["-y", "@neonwatty/food-tracker-mcp"],
      "env": {
        "USDA_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add food-tracker -e USDA_API_KEY=your_api_key -- npx -y @neonwatty/food-tracker-mcp
```

Or add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "food-tracker": {
      "command": "npx",
      "args": ["-y", "@neonwatty/food-tracker-mcp"],
      "env": {
        "USDA_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Requirements

### USDA API Key

Get your free API key at: https://fdc.nal.usda.gov/api-key-signup/

## Available Tools

### search_food
Search the USDA FoodData Central database for foods.

```
"Search for chicken breast"
```

Returns nutrition information per 100g serving including calories, protein, carbs, and fat.

### log_food
Log a food entry to your daily food diary.

```
"Log 200g of grilled salmon for lunch with 400 calories, 40g protein, 0g carbs, 22g fat"
```

Parameters:
- `food_name` (required): Name of the food
- `serving_size` (required): Amount of the serving
- `serving_unit` (required): Unit (g, oz, cup, piece, etc.)
- `calories` (required): Calories for this serving
- `protein_g`: Protein in grams
- `carbs_g`: Carbohydrates in grams
- `fat_g`: Fat in grams
- `fiber_g`: Fiber in grams
- `meal`: breakfast, lunch, dinner, or snack
- `date`: Date in YYYY-MM-DD format (defaults to today)

### get_daily_log
Get all food entries for a specific day with totals and goal comparison.

```
"What have I eaten today?"
"Show me my food log for 2025-01-15"
```

### set_goals
Set your daily nutrition goals.

```
"Set my daily goal to 2000 calories with 150g protein, 200g carbs, and 65g fat"
```

### get_summary
Get nutrition summary and averages for a date range.

```
"Show me my nutrition summary for this week"
"Get my monthly nutrition averages"
```

### delete_entry
Delete a food log entry by its ID.

```
"Delete entry 5"
```

## Data Storage

Food logs are stored locally in a SQLite database at `~/.food-tracker/food.db`. Your data never leaves your machine.

## Example Conversation

**You**: Search for oatmeal
**Claude**: Found 10 foods matching "oatmeal"...

**You**: Log 1 cup of oatmeal for breakfast
**Claude**: Logged: Oatmeal (1 cup) - 150 cal | P: 5g | C: 27g | F: 3g

**You**: What have I eaten today?
**Claude**: Food Log for 2025-01-15...

## License

MIT License - see [LICENSE](LICENSE) for details.

## Contributing

Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/neonwatty/food-tracker-mcp).