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)

From Source

1. Clone this repository

2. Install dependencies:

   npm install

3. 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.json Windows: %APPDATA%\Claude\claude_desktop_config.json

NPM Installation Configuration:

Local Installation Configuration:

For Cursor

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

For Continue.dev

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

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:

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:

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:

search_food

Search for calorie information of specific foods.

Parameters:

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

Example:

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