Open source · read & write · Model Context Protocol

Talk to your Cronometer data from your AI assistant.

Cronometer MCP is the connector that lets ChatGPT, Claude, Cursor, and other AI assistants use your food log, daily nutrition, biometrics, and fasting history. See what remains, log what you actually ate, and plan macros in plain language.

Independent, open-source connector for Cronometer.

claude · sunday morning

Works with

  • ChatGPT
  • Codex
  • Poncho
  • OpenClaw
  • Hermes
  • Cursor
  • Claude Desktop
  • Claude Code
  • Gemini CLI
  • VS Code
  • Windsurf

The problem

Your Cronometer data is useful. Getting answers from it should be easier.

Your food log holds the evidence—but answering a simple question still means opening diary screens, doing macro arithmetic, and exporting spreadsheets.

Know what comes next

You want tonight’s meal to fit what remains—not another screen of consumed totals to eyeball and do the math on.

Record real life accurately

You remember exactly what you ordered, but no database entry matches it, so honest logging turns into guesswork.

Plan without spreadsheets

Multi-week questions live behind CSV exports and manual comparison, so the next plan never quite starts from your data.

Instead of doing arithmetic over diary screens, ask in plain language and get an answer grounded in specific entries.

What you can do

Watch a goal become a plan.

The weight-loss flow, start to finish: ask in plain language, get targets built from your own logged history, review before anything changes—and Cronometer updates only after you approve.

  1. 01

    Ask in plain language

    “I want to start losing weight. Can you set my macros?” No forms, no fields—the goal is the whole request.

  2. 02

    Your assistant reads your history

    get_macro_targets and get_meal_history pull your current targets and a month of logged meals. The math comes from your record—2,480 kcal eaten against roughly 2,580 burned—not a generic formula.

  3. 03

    Review the proposal first

    The plan lands as a review card—2,330 kcal · 150P / 275C / 70F, protein anchored near 1.8 g per kg, extra carbs on training days—with the reasoning spelled out.

  4. 04

    Your approval does the writing

    Say the word and set_macro_targets updates Cronometer directly. Your assistant closes the loop with what your own log shows: weekdays already fit—weekends are where you went over.

claude · sunday morning

More you can ask

01

Understand your nutrition

Summarize days or weeks of logging to see where macros drifted, which days held together, and the entries behind the trend.

YOU COULD ASK

“Review my last four weeks and show where my macros drifted from target.”

A trend summary grounded in specific entries

02

Log what you actually ate

Describe the odd substitution or custom order in plain language. Your assistant works out the nutrition and creates a reusable custom food in Cronometer.

YOU COULD ASK

“Add my Starbucks drink, but swap in their protein milk.”

Custom nutrition without manual data entry

03

Decide what to eat next

Cronometer shows what remains. Your assistant turns those remaining calories and macros into a meal that fits your preferences, schedule, and training day.

YOU COULD ASK

“I lift in two hours. What can I eat with today’s remaining macros?”

A practical meal, not another dashboard

And the everyday jobs that add up

Build recipes from ingredientsEstimate restaurant mealsReview weekly nutrition trendsAdjust training and rest daysCopy repeatable meal plansAdd fasting and biometric context

Trend reviews can also fold in other data you choose to give your assistant—training logs, weight trends, energy expenditure. Cronometer MCP supplies the nutrition side of that context.

Tool manifest

16 focused tools behind every answer.

Everything your day revolves around—meals, macros, fasting, and body metrics—is readable straight from your log, and your assistant only writes when you ask it to.

Diary & food log

  • get_food_log
  • add_food_entry
  • mark_day_complete
  • copy_day
  • remove_food_entry

Food database

  • search_foods
  • get_food_details
  • add_custom_food
  • add_recipe

Nutrition & macros

  • get_daily_nutrition
  • get_macro_targets

Fasting

  • get_fasting_history
  • get_fasting_stats

Biometrics

  • list_biometrics
  • get_biometrics

Bulk exports

  • get_cronometer_data

daily_nutrition · servings · exercises · biometrics · notes

readwritedestructive

Explore the complete tool manifest on GitHub

Setup

Connect Cronometer.
Ask your first question.

One endpoint, one browser sign-in. There are no API keys—authorization exchanges your Cronometer login for scoped sessions and discards the credentials. Pick your client below—browser assistants and terminal agents each have a two-minute path.

01

Grab the endpoint

Every client connects to the same /mcp endpoint:

02

Sign in once

The first connection opens /authorize, where you enter your Cronometer username, password, and one-time code if you use two-factor authentication. The Worker exchanges them for web and mobile sessions immediately.

03

Ask your first question

Confirm the link read-only with “Which Cronometer account is connected?” — answered by connection_status. Then try the real thing: “What can I eat with today’s remaining macros?”

Pick your client

ChatGPT

Browser app

Custom connectors live behind developer mode; works on any plan that has it.

  1. 01

    Open Settings → Apps & Connectors → Advanced settings and switch Developer mode on.

  2. 02

    Back under Apps & Connectors, choose Create next to Custom connectors, name it “Cronometer”, and paste the endpoint URL.

  3. 03

    Click Authenticate—the Cronometer sign-in opens in a popup. Enter your username, password, and one-time code, then approve access.

  4. 04

    Enable Cronometer in the connector picker for your chat and ask “Which Cronometer account is connected?”

Connector URL

Every client shares the same trust boundary: credentials are exchanged once at /authorize and never stored. If a session expires upstream, reconnect through the same flow—one more sign-in, nothing to rotate.

Questions, answered

Know what you are connecting before you start.

The short version: no API keys, no install, credentials are never stored, and the whole server is open source if you would rather read it than trust it.

What is Cronometer MCP?+

An independent, open-source connector that lets ChatGPT, Claude, Cursor, and other MCP clients read and write data in your Cronometer account—food log, daily nutrition, biometrics, fasting history, and bulk exports.

Do I need a Cronometer API key?+

No. Cronometer does not offer a public API, so the server signs in once with your Cronometer username, password, and one-time code during authorization. There is nothing to create, manage, or rotate.

Do I need to install anything?+

No. The hosted endpoint serves OAuth discovery, dynamic client registration, and all 16 tools. If you prefer your own deployment, the same open-source Worker runs on any Cloudflare account.

Which assistants work with Cronometer MCP?+

Any MCP client that connects to a remote server over HTTP—ChatGPT connectors, Claude, Cursor, VS Code, Codex, and others. Every tool carries MCP annotations regardless of which client you use.

Is my password stored?+

No. Credentials are exchanged exactly once at authorization for web and mobile sessions, which live inside the encrypted OAuth grant. Your password and one-time code are never persisted and never embedded in an MCP token.

Can it change my Cronometer account?+

Yes. Write tools cover food entries, custom foods, recipes, day copying, and day completion. Each tool declares whether it is read-only, idempotent, or destructive, so compatible clients can require confirmation before anything mutates.

Is this an official Cronometer product?+

No. Cronometer MCP is an independent open-source project and is not affiliated with or endorsed by Cronometer.com.

Put your Cronometer data to work.

Connect in the browser for the shortest path—no local install required. Prefer control? Run the same open-source Worker on your own Cloudflare account.

Connect Cronometer