Daily Calorie Tracker MCP Server

A Model Context Protocol (MCP) server for tracking daily calorie consumption through natural language interactions.

Features

Natural Language Meal Entry: Log meals using descriptions like "chicken salad and a glass of milk"
Daily Summaries: Get total calorie intake with meal breakdowns
Weekly Reports: View average consumption, trends, and achievement tracking
Food Search: Look up calorie information for specific foods
Persistent Storage: SQLite database for cross-session data retention

Installation

Via npm (Recommended)

npm install -g daily-calorie-tracker-mcp

From Source

Clone this repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

MCP Server Configuration

For Claude Desktop

Add to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

NPM Installation Configuration:

{
  "mcpServers": {
    "daily-calorie-tracker": {
      "command": "npx",
      "args": ["-y", "daily-calorie-tracker-mcp"]
    }
  }
}

Local Installation Configuration:

{
  "mcpServers": {
    "daily-calorie-tracker": {
      "command": "node",
      "args": ["/path/to/daily-calorie-tracker/dist/index.js"]
    }
  }
}

For Cursor

Add to your Cursor settings (~/.cursor/settings.json):

{
  "mcpServers": {
    "daily-calorie-tracker": {
      "command": "npx",
      "args": ["-y", "daily-calorie-tracker-mcp"]
    }
  }
}

For Continue.dev

Add to your Continue configuration (~/.continue/config.json):

{
  "models": [
    {
      "model": "claude-3-5-sonnet-latest",
      "provider": "anthropic",
      "mcpServers": [
        {
          "name": "daily-calorie-tracker",
          "command": "npx",
          "args": ["-y", "daily-calorie-tracker-mcp"]
        }
      ]
    }
  ]
}

Available MCP Tools

The server provides the following tools:

`add_meal`

Log a meal with natural language description.

Parameters:

description (string, required): Natural language description of the meal (e.g., "chicken salad and a glass of milk")
mealType (string, required): Type of meal - "breakfast", "lunch", "dinner", or "snack"

Example:

Add breakfast: oatmeal with banana and coffee

`get_daily_summary`

Get today's calorie intake summary with meal breakdown.

Parameters:

date (string, optional): Date in YYYY-MM-DD format (defaults to today)

Example:

Show today's calorie summary

`get_weekly_report`

Generate a weekly calorie consumption report with statistics.

Parameters:

startDate (string, optional): Start date in YYYY-MM-DD format (defaults to 7 days ago)

Example:

Generate weekly report

`search_food`

Search for calorie information of specific foods.

Parameters:

foodName (string, required): Name of the food to search

Example:

Search calories for pizza

Usage Examples

Once configured, you can use natural language to track your calories:

"Log breakfast: oatmeal with banana and coffee"
"Add lunch: grilled chicken salad and apple juice"
"Record dinner: pasta with tomato sauce and a glass of wine"
"I had a snack: apple and yogurt"
"Show today's calorie summary"
"What did I eat today?"
"Generate weekly report"
"Show my calorie trends for this week"
"Search calories for pizza"
"How many calories in chicken breast?"

Data Storage

Data is stored in SQLite database at:

MacOS/Linux: ~/.daily-calorie-tracker/calories.db
Windows: %USERPROFILE%\.daily-calorie-tracker\calories.db

Food Database

The server includes a comprehensive food database with 100+ common foods organized by categories:

Proteins (chicken, beef, fish, eggs, tofu, etc.)
Carbohydrates (rice, pasta, bread, potatoes, etc.)
Vegetables (broccoli, spinach, tomatoes, etc.)
Fruits (apples, bananas, berries, etc.)
Beverages (milk, juice, coffee, tea, etc.)
Dairy products (cheese, yogurt, butter, etc.)
Common meals (hamburger, pizza, sandwiches, etc.)
Snacks (chips, nuts, chocolate, etc.)

Development

npm run dev - Run in development mode
npm run build - Build for production
npm start - Run production build

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

Repository

GitHub: https://github.com/VeriTeknik/daily-calorie-tracker

Daily Calorie Tracker MCP Server