# Cronometer

> Cronometer is an MCP server for health and science. Read and edit your Cronometer food diary, macros, fasts and biometrics from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/cphoskins/cronometer-mcp
- **MCP Registry name:** io.github.cphoskins/cronometer
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science), [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-14

## About

This server logs into a Cronometer account with your email and password and exposes the diary to an assistant. It can pull individual food entries with micronutrients, daily calorie and macro totals, and period averages, and it can search the Cronometer food database before adding an entry.

Write tools cover adding or removing entries, copying a whole day, marking a day complete, recurring foods, macro targets and templates, fasts and biometrics such as weight and blood glucose. Setting `CRONOMETER_READ_ONLY=1` hides the 13 tools that change the account, though the README warns the password itself still has full access.

It needs a Cronometer Gold or other paid account that supports web login. The default transport is stdio; a streamable HTTP mode exists but the README stresses that endpoint has no authentication and should stay on loopback or a private network.

## Features

- **Food log and micronutrients:** Per-entry macros and micros for a date range, plus period averages.
- **Diary editing:** Add or remove entries, copy a day and mark days complete.
- **Recurring foods:** Create and delete items that auto-log on chosen days.
- **Macro targets:** Read and write daily targets, templates and weekly schedules.
- **Read-only mode:** An environment variable removes the 13 write tools.
- **Sync to disk:** Downloads JSON exports and builds a Markdown food log.

## Good for

- Ask an assistant to summarise this week's protein and fibre
- Log a meal by chatting instead of using the app
- Review fasting history and biometrics together
- Export raw servings data as CSV

## Install

### Claude Code (Terminal)

```sh
claude mcp add cronometer --env CRONOMETER_USERNAME='<CRONOMETER_USERNAME>' --env CRONOMETER_PASSWORD='<CRONOMETER_PASSWORD>' -- uvx cronometer-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cronometer": {
      "command": "uvx",
      "args": [
        "cronometer-mcp"
      ],
      "env": {
        "CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
        "CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cronometer": {
      "command": "uvx",
      "args": [
        "cronometer-mcp"
      ],
      "env": {
        "CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
        "CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cronometer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cronometer-mcp"
      ],
      "env": {
        "CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
        "CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cronometer": {
      "command": "uvx",
      "args": [
        "cronometer-mcp"
      ],
      "env": {
        "CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
        "CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cronometer": {
      "command": "uvx",
      "args": [
        "cronometer-mcp"
      ],
      "env": {
        "CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
        "CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `get_food_log`: Individual food entries with macros and micros for a date range.
- `get_daily_nutrition`: Daily calorie, protein, carb, fat and fiber totals.
- `get_micronutrients`: Vitamin and mineral breakdown with period averages.
- `export_raw_csv`: Raw CSV export for servings, exercises, biometrics and more.
- `search_foods`: Search the Cronometer food database.
- `get_food_details`: 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 complete or incomplete.
- `get_repeated_items`: List recurring food entries.
- `add_repeat_item`: Add a recurring entry that auto-logs on selected days.
- `delete_repeat_item`: Delete a recurring food entry.
- `get_macro_targets`: Read daily macro targets or the weekly schedule.
- `set_macro_targets`: Update daily macro targets.
- `list_macro_templates`: List saved macro target templates.
- `create_macro_template`: Create a saved macro target template.
- `set_weekly_macro_schedule`: Assign a template to days of the week.
- `sync_cronometer`: Download JSON exports and generate a Markdown food log on disk.

## FAQ

### Which Cronometer plan is needed?

A Gold account or any paid tier that supports web login.

### Can it be made read-only?

Yes, set CRONOMETER_READ_ONLY=1; the credentials still keep full account access.

### Is the HTTP mode safe to expose?

The README says the endpoint has no authentication, so keep it on 127.0.0.1 or behind a trusted network or authenticating proxy.

### How is it installed?

`pip install cronometer-mcp`, then add the command and credentials to your client config.

### How do I add Cronometer to Claude Code?

Run this command in your terminal: claude mcp add cronometer --env CRONOMETER_USERNAME='<CRONOMETER_USERNAME>' --env CRONOMETER_PASSWORD='<CRONOMETER_PASSWORD>' -- uvx cronometer-mcp

### What are the best alternatives to Cronometer?

The closest alternatives to Cronometer are Cronometer MCP, Fatsecret MCP, Forkmate, MyFitnessPal MCP and Remembite.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Cronometer MCP](https://ai-powered.com/mcp/cronometer-mcp): Cronometer MCP is an open-source MCP server for health and science.
- [Fatsecret MCP](https://ai-powered.com/mcp/fatsecret-mcp-2): Fatsecret MCP is an open-source MCP server for food and drink.
- [Forkmate](https://ai-powered.com/mcp/forkmate): Forkmate is a free MCP server for health and science.
- [MyFitnessPal MCP](https://ai-powered.com/mcp/myfitnesspal-mcp): MyFitnessPal MCP is an open-source MCP server for health and science.
- [Remembite](https://ai-powered.com/mcp/remembite): Remembite is a free MCP server for health and science.
- [Smacros: smarter macro tracking](https://ai-powered.com/mcp/smacros-smarter-macro-tracking): Smacros: smarter macro tracking is an MCP server for health and science.
- [Nutrition MCP](https://ai-powered.com/mcp/nutrition-mcp-2): Nutrition MCP is an open-source MCP server for health and science.
- [Food Tracker](https://ai-powered.com/mcp/food-tracker): Food Tracker is a free MCP server for health and science.

---
Source: https://ai-powered.com/mcp/cronometer
