README.md
Access your Cronometer nutrition data from Claude or Cursor.
cronometer-mcp
An MCP (Model Context Protocol) server that provides access to your Cronometer nutrition data. Pull detailed food logs, daily macro/micro summaries, manage diary entries, fasting, biometrics, and recurring foods — all from Claude, Cursor, or any MCP-compatible client.
Requires a Cronometer Gold account (or any paid tier that supports web login).
Features
- Food log — individual food entries with full macro and micronutrient breakdown
- Daily nutrition — daily calorie, protein, carb, fat, and fiber totals
- Micronutrients — detailed vitamin/mineral breakdown with period averages
- Diary management — add/remove food entries, copy entire days, mark days complete
- Recurring foods — create, list, and delete repeat items that auto-log on selected days
- Macro targets — read/write daily targets, create templates, set weekly schedules
- Fasting — view history and stats, cancel or delete fasts
- Biometrics — log and remove weight, blood glucose, heart rate, body fat
- Raw CSV export — servings, daily summary, exercises, biometrics, or notes
- Sync to disk — download JSON exports and generate a markdown food log
Quick Start
1. Install
pip install cronometer-mcp
Or install from source:
git clone https://github.com/cphoskins/cronometer-mcp.git
cd cronometer-mcp
pip install -e .
2. Set credentials
export CRONOMETER_USERNAME="your@email.com"
export CRONOMETER_PASSWORD="your-password"
Or add them to a .env file in your project root (if your MCP client supports it).
3. Configure your MCP client
Claude Code (`.mcp.json`)
{
"mcpServers": {
"cronometer": {
"command": "cronometer-mcp",
"env": {
"CRONOMETER_USERNAME": "your@email.com",
"CRONOMETER_PASSWORD": "your-password"
}
}
}
}
Claude Desktop (`claude_desktop_config.json`)
{
"mcpServers": {
"cronometer": {
"command": "cronometer-mcp",
"env": {
"CRONOMETER_USERNAME": "your@email.com",
"CRONOMETER_PASSWORD": "your-password"
}
}
}
}
If you installed from source with pip install -e ., you can also use the full Python path:
{
"command": "/path/to/venv/bin/python",
"args": ["-m", "cronometer_mcp.server"]
}
Available Tools
Food Log & Nutrition
| Tool | Description |
|---|---|
get_food_log |
Individual food entries with macros + micros for a date range |
get_daily_nutrition |
Daily macro totals (calories, protein, carbs, fat, fiber) |
get_micronutrients |
Detailed vitamin/mineral breakdown with period averages |
export_raw_csv |
Raw CSV export for any data type (servings, exercises, biometrics, etc.) |
Food Search & Diary Management
| Tool | Description |
|---|---|
search_foods |
Search the Cronometer food database |
get_food_details |
Get full nutrition info and serving measure IDs for a food |
add_food_entry |
Add a food entry to the diary |
remove_food_entry |
Remove a food entry from the diary |
copy_day |
Copy all diary entries from one date to another |
set_day_complete |
Mark a diary day as complete or incomplete |
Recurring Foods (Repeat Items)
| Tool | Description |
|---|---|
get_repeated_items |
List all recurring food entries |
add_repeat_item |
Add a recurring food entry that auto-logs on selected days |
delete_repeat_item |
Delete a recurring food entry |
Macro Targets & Templates
| Tool | Description |
|---|---|
get_macro_targets |
Get daily macro targets (or full weekly schedule with target_date="all") |
set_macro_targets |
Update daily macro targets (partial updates supported) |
list_macro_templates |
List all saved macro target templates |
create_macro_template |
Create a new saved macro target template |
set_weekly_macro_schedule |
Assign a template to days of the week as the recurring default |
Fasting
| Tool | Description |
|---|---|
get_fasting_history |
View all fasts or fasts within a date range |
get_fasting_stats |
Aggregate fasting statistics (total hours, longest, averages) |
cancel_active_fast |
Cancel an in-progress fast while preserving the recurring schedule |
delete_fast |
Delete a fast entry |
Biometrics
| Tool | Description |
|---|---|
get_recent_biometrics |
Get recently logged biometric entries |
add_biometric |
Log weight (lbs), blood glucose (mg/dL), heart rate (bpm), or body fat (%) |
remove_biometric |
Remove a biometric entry |
Sync
| Tool | Description |
|---|---|
sync_cronometer |
Download JSON exports + generate food-log.md to disk |
Tool Parameters
All date parameters use YYYY-MM-DD format. Most tools de
Tools (6)
get_food_logIndividual food entries with macros and micros for a date range.get_daily_nutritionDaily macro totals including calories, protein, carbs, fat, and fiber.get_micronutrientsDetailed vitamin and mineral breakdown with period averages.search_foodsSearch the Cronometer food database.add_food_entryAdd a food entry to the diary.add_biometricLog weight, blood glucose, heart rate, or body fat.Environment Variables
CRONOMETER_USERNAMErequiredYour Cronometer account email address.CRONOMETER_PASSWORDrequiredYour Cronometer account password.Configuration
claude_desktop_config.json
{
"mcpServers": {
"cronometer": {
"command": "cronometer-mcp",
"env": {
"CRONOMETER_USERNAME": "your@email.com",
"CRONOMETER_PASSWORD": "your-password"
}
}
}
}Try it
→What were my total calories and protein intake for yesterday?
→Search for 'oatmeal' and add 1 serving to my diary for today.
→Log my weight as 180 lbs for today.
→Show me my average vitamin D intake over the last 30 days.
→Sync my recent Cronometer data to a markdown file.