cronometer — Claude Code MCP server: features and setup
Connect an agent to Cronometer food logs, nutrition summaries and diary controls. A paid Cronometer account with web login is required.
claude mcp add --env CRONOMETER_USERNAME=<CRONOMETER_USERNAME> --env CRONOMETER_PASSWORD=<CRONOMETER_PASSWORD> --env CRONOMETER_DATA_DIR=<CRONOMETER_DATA_DIR> --transport stdio cronometer -- uvx cronometer-mcpWhat cronometer does
The server lets an agent read food entries across a date range, daily calorie and macro totals, and vitamin and mineral details. It can search Cronometer’s food database, edit diary entries, copy a day, and manage foods scheduled to recur. Other tools cover fasting records, biometrics and data exports.
Set CRONOMETER_USERNAME and CRONOMETER_PASSWORD for account access. Cronometer Gold or another paid plan with web login is required. You can expose read tools only with CRONOMETER_READ_ONLY=1. The remote HTTP endpoint has no authentication, so anyone who can reach it could read or change the account held by the server.
For Claude Code, add the server with claude mcp add and run it through uvx cronometer-mcp. The second installation command also accepts CRONOMETER_DATA_DIR; both commands require the Cronometer login credentials.
What it helps with
- review calories and macros across selected dates
- find a food and check its nutrition details
- add or remove diary entries
- inspect fasting history and biometric records
- export Cronometer data as CSV
Example prompts for the agent
- Show my Cronometer food entries and calorie totals for the selected dates.
- Find a food in Cronometer and add it to today's diary.
- Compare my daily protein, fat and carbohydrate totals across these dates.
How to install cronometer
Platform CLI
claude mcp add --env CRONOMETER_USERNAME=<CRONOMETER_USERNAME> --env CRONOMETER_PASSWORD=<CRONOMETER_PASSWORD> --env CRONOMETER_DATA_DIR=<CRONOMETER_DATA_DIR> --transport stdio cronometer -- uvx cronometer-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cronometer-mcp <command>
Platform CLI
codex mcp add cronometer --env CRONOMETER_USERNAME=<CRONOMETER_USERNAME> --env CRONOMETER_PASSWORD=<CRONOMETER_PASSWORD> --env CRONOMETER_DATA_DIR=<CRONOMETER_DATA_DIR> -- uvx cronometer-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cronometer-mcp <command>
Config file
{
"mcpServers": {
"cronometer": {
"command": "uvx",
"args": [
"cronometer-mcp"
],
"env": {
"CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
"CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>",
"CRONOMETER_DATA_DIR": "<CRONOMETER_DATA_DIR>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cronometer-mcp <command>
Config file
{
"servers": {
"cronometer": {
"type": "stdio",
"command": "uvx",
"args": [
"cronometer-mcp"
],
"env": {
"CRONOMETER_USERNAME": "<CRONOMETER_USERNAME>",
"CRONOMETER_PASSWORD": "<CRONOMETER_PASSWORD>",
"CRONOMETER_DATA_DIR": "<CRONOMETER_DATA_DIR>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cronometer-mcp <command>
Platform CLI
gemini mcp add -e CRONOMETER_USERNAME=<CRONOMETER_USERNAME> -e CRONOMETER_PASSWORD=<CRONOMETER_PASSWORD> -e CRONOMETER_DATA_DIR=<CRONOMETER_DATA_DIR> cronometer uvx cronometer-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cronometer-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about cronometer
How do I install cronometer in Claude Code?
Run claude mcp add cronometer -e CRONOMETER_USERNAME=<CRONOMETER_USERNAME> -e CRONOMETER_PASSWORD=<CRONOMETER_PASSWORD> -- uvx cronometer-mcp. Replace the placeholders with your Cronometer login details.
What does cronometer do?
It gives an agent access to Cronometer nutrition data and diary actions, including food lookup, entry changes and data export.
What Cronometer account does cronometer require?
Use Cronometer Gold or another paid plan that supports web login.
