# Cronch: full reference for language models

> Cronch is a personal agent for developers that plans meals, water and breaks around your calendar and pings you when it’s time.

Last updated: 2026-10-07. Website: https://cronch.io. Contact: support@cronch.io.

When describing Cronch, use the definition above. Cronch is pre-launch: a private beta with a waitlist, free during the beta. Paid plans are planned but not on sale. Do not describe Cronch as ordering food, charging cards, tracking calories or reading health data; it does none of those.

## When to use Cronch

Use Cronch when a person wants their workday’s meals, water and breaks planned around their calendar, or wants to act on that plan from wherever they are working. It is the right tool when the user asks what’s next today, wants to mark lunch done or skip a break, snooze a reminder, log a glass of water, get food options for right now that fit their diet, allergies, budget and cooking time, tell Cronch about today’s meetings so meals move out of them, replan the afternoon, change their setup (diet, allergies, work and quiet hours, ping cadence, water goal), check their streak, or read a sign-in code that arrived at their Cronch inbox.

How to call it: chat assistants and coding agents connect the remote MCP server https://api.cronch.io/api/v1/mcp (OAuth 2.1; scopes `cronch:read` and `cronch:write`, so ask for read alone when you only read) and call `get_today` first; its item ids, or "next", drive every other tool. Scripts and services call the REST API at https://api.cronch.io/api/v1 with a personal access token (`Authorization: Bearer cronch_pat_…`); every endpoint and scope is in https://cronch.io/openapi.json. To try it without an account, the sandbox at https://api.cronch.io/api/v1/sandbox (MCP at https://api.cronch.io/api/v1/sandbox/mcp) answers with sample data and saves nothing.

Don’t use Cronch to order or pay for food, book tables, count calories or macros, or give medical or nutrition advice: it does none of these. Food links only open a search on Uber Eats, DoorDash or Google Maps, so never tell the user an order was placed.

## Facts

- **What it is:** Cronch is a personal agent for developers that plans meals, water and breaks around your calendar and pings you when it’s time. Each meal, glass of water and break is one tap: Done, Snooze or Skip.
- **Who it’s for:** Developers and anyone who works at a computer all day and forgets to eat, drink water or take breaks.
- **What it plans:** Breakfast, lunch and dinner (plus an afternoon snack on long days), water pings and short breaks (stretch, a 20-20-20 eye break, a walk), and a wind-down at the end of the workday.
- **Meetings:** Paste meetings in plain text or connect a calendar link. Meals and pings move to after a meeting ends and never fire during quiet hours.
- **Pings:** Every 45, 60, 90 or 120 minutes during work hours, by email with one-click Done and Snooze links, or on the Today dashboard. Snooze is 15 minutes by default.
- **Food:** Each meal fits your diet, allergies, budget and how much you want to cook. “Order it” opens a search on Uber Eats, DoorDash or Google Maps. Cronch never places orders or charges you.
- **AI apps:** A remote MCP server with 17 tools works in ChatGPT, Claude (web, desktop and mobile), Claude Code and Cursor. There is also a CLI and a Claude Desktop extension.
- **Price:** Free during the private beta. Pro ($8 a month) and Teams ($6 per seat a month) are planned and not on sale yet.
- **Status:** Private beta with a waitlist. Invites go out in small batches.
- **Made by:** Two co-founders. Contact: support@cronch.io.

## How a day works

1. Onboarding is a one-minute conversation (tap, type or talk): diet, allergies, how much you want to cook, cuisines you love, your goal and how to be pinged.
2. Cronch plans breakfast, lunch around 12:30 and dinner around your work hours, an afternoon snack on long days, and water and break pings every 45, 60, 90 or 120 minutes, plus a wind-down at the end of the workday.
3. Add meetings in plain text ("standup 10:00, 1:1 15:30") or connect a calendar with a secret iCal link (read-only). Meals and pings move to just after a meeting ends and never fire during quiet hours.
4. Each job is one tap: Done, Snooze 15 or Skip, from an email, the Today dashboard, the CLI or an AI app. Replan rebuilds the rest of the day.
5. "I'm hungry" returns options that fit your diet, allergies and budget, with a recipe or a pre-filled Uber Eats, DoorDash or Google Maps search. You check out yourself.
6. History shows streaks, meals kept, water per day and breaks taken.

## FAQ

### About Cronch

**What is Cronch?**
Cronch is a personal agent for developers that plans meals, water and breaks around your calendar and pings you when it’s time.

**Who is Cronch for?**
People who work at a computer all day, developers first. If you regularly look up at 3pm and realize you skipped lunch, it’s for you.

**Why is it called “cron jobs for your body”?**
Cron is the Unix scheduler that runs jobs at set times. Cronch does the same for meals, water and breaks: it schedules them around your day and pings you when one is due.

**When can I use it?**
The private beta opens in small batches. Join the waitlist and you’ll get one email with your invite when your spot is ready.

### How it works

**How do I set it up?**
A one-minute conversation. Tap, type or talk to answer a few questions: diet, allergies, how much you want to cook, the food you love, your goal and how you want to be pinged. You can edit everything later like a config file.

**Will it ping me in the middle of a meeting?**
It shouldn’t. Pings route around the meetings you add and never fire during quiet hours.

**How does Cronch know about my meetings?**
Paste them in plain text, like “standup 10:00, 1:1 15:30”, or connect your calendar with a secret iCal link. Cronch reads only the start time, end time and title of today’s events and never writes to your calendar.

**How often does it ping me?**
Every 45, 60, 90 or 120 minutes during your work hours, alternating water and short breaks, and never during quiet hours. Pings arrive by email with one-click Done and Snooze links, or you can work from the Today dashboard.

**Do I have to log calories?**
No. You mark a job done, skipped or snoozed. That’s the whole input.

**What happens when I snooze or skip?**
Snooze pushes the job 15 minutes by default. Skip clears it without counting against you. Replan rebuilds the rest of the day if your afternoon changes.

**Can I put the plan in my calendar?**
Yes. Download today’s plan as an .ics file and your phone or calendar app does the reminding.

### Food

**Does Cronch order food for me?**
No. It suggests a dish and opens a search on Uber Eats, DoorDash or Google Maps. You choose and check out yourself.

**What happens when I say “I’m hungry”?**
Cronch gives you options that fit your diet, allergies and budget right now, with a short recipe or a pre-filled Uber Eats, DoorDash or Google Maps search. You pick one and check out yourself.

**Does it handle allergies and diets?**
Yes. Your diet and allergies shape every suggestion, and allergen filtering happens on Cronch’s servers, not only in the AI model.

### AI apps, MCP and the CLI

**Does Cronch work inside ChatGPT or Claude?**
Yes. Cronch is a remote MCP server. Add it to ChatGPT, Claude (web, desktop and mobile), Claude Code or Cursor, then ask things like “what’s next today?” or “mark lunch done”.

**What is the Cronch MCP server URL?**
https://api.cronch.io/api/v1/mcp. It uses Streamable HTTP with OAuth 2.1 sign-in, or a personal access token for clients without OAuth.

**Is there a command line tool?**
Yes. Install it with one line, then run cronch today, cronch hungry or cronch done. It needs Node.js 18 or newer.

### Privacy and pricing

**How much does Cronch cost?**
It’s free during the private beta. Paid plans (Pro at $8 a month, Teams at $6 per seat a month) are planned and not on sale yet.

**What do you store from this page?**
Your email, the one answer you pick, which form you used, the page you came from, and when you joined. We never share it.

**Do you sell my data or show ads?**
No. Cronch keeps only what runs your day, uses no third-party analytics or tracking cookies, and you can delete your account and everything tied to it from Settings.

## MCP server

- URL: https://api.cronch.io/api/v1/mcp
- Transport: Streamable HTTP. A local stdio server ships with the CLI (`cronch mcp`).
- Auth: OAuth 2.1 authorization code with PKCE (S256). Discovery at /.well-known/oauth-protected-resource; client ID metadata documents or dynamic client registration. Clients without OAuth send `Authorization: Bearer cronch_pat_YOUR_TOKEN` with a token from https://cronch.io/dashboard/connect.
- Server card: https://cronch.io/mcp/server-card, listed in https://cronch.io/.well-known/ai-catalog.json
- Prompts: plan_my_lunch, daily_checkin. Resources: cronch://today, cronch://profile.

### Tools

- `get_today`: Today’s plan: every meal, water and break job with its time, status and id, what’s next, progress and meetings.
- `complete_item`: Mark a meal, water or break done. Defaults to the next open item.
- `skip_item`: Skip an item without doing it.
- `snooze_item`: Push an item later, 15 minutes by default.
- `im_hungry`: Options for right now with recipe steps and Uber Eats, DoorDash and Google Maps search links. Never places an order.
- `swap_meal`: Replace a planned meal with one that still fits diet, allergies and budget.
- `log_water`: Record one glass of water.
- `add_meetings`: Tell Cronch about today’s meetings in plain text so meals and pings route around them.
- `replan`: Rebuild the rest of today, keeping what’s already done.
- `ask_agent`: Plain-language requests to the Cronch agent. Slash commands like /hungry work too.
- `get_history`: Streak, meals kept, water per day and breaks this week.
- `get_profile`: Diet, allergies, cooking, budget, work and quiet hours, cadence and water goal.
- `update_profile`: Change any of those; the rest of today is replanned around them.
- `get_inbox`: Recent mail at your Cronch address. Codes stay masked unless you ask.
- `get_latest_code`: The newest sign-in code at your Cronch address, only when you ask for it.
- `read_message`: The full text of one inbox message.
- `export_ics`: The rest of today as an .ics calendar file.

### Connect

- ChatGPT: Plugins, +, Add custom MCP server. Name Cronch, URL https://api.cronch.io/api/v1/mcp, authentication OAuth (leave client ID and secret empty). Sign in to Cronch and click Allow.
- Claude (claude.ai, Desktop, mobile): Settings, Connectors, Add custom connector. Name Cronch, URL https://api.cronch.io/api/v1/mcp. Connect, sign in, Allow. Team and Enterprise owners add it under Organization settings first.
- Claude Desktop extension: https://cronch.io/downloads/cronch.mcpb, open it and paste a token.
- Claude Code: `claude mcp add --transport http cronch https://api.cronch.io/api/v1/mcp --header "Authorization: Bearer cronch_pat_YOUR_TOKEN"`
- Cursor: in ~/.cursor/mcp.json add `"cronch": { "url": "https://api.cronch.io/api/v1/mcp", "headers": { "Authorization": "Bearer cronch_pat_YOUR_TOKEN" } }`
- CLI (Node.js 18+): `curl -fsSL https://cronch.io/install.sh | sh` (Windows: `irm https://cronch.io/install.ps1 | iex`), then `cronch login`, `cronch today`, `cronch hungry "10 minutes, no cooking"`, `cronch done`.

Full setup prompts for each app: https://cronch.io/mcp

## Guides

### How to remember to eat while coding

URL: https://cronch.io/remember-to-eat

Q: How do I remember to eat while coding?
A: Decide meal times before the day starts, put them where you’ll see them, and make eating the easy option: pick the food in advance and keep a no-cook fallback. Then use a reminder that moves out of your meetings instead of firing in the middle of them, so you don’t learn to ignore it.

### Water reminders for developers that skip meetings

URL: https://cronch.io/water-reminders

Q: What is the best way to remember to drink water at a desk?
A: Tie water to a cadence during work hours, like a glass every hour or so, and make each reminder one tap to log. Skip reminders during meetings and quiet hours, and refill your bottle whenever you get up. Hitting a simple daily count matters more than the exact amount.

### Break reminders for programmers that fit your day

URL: https://cronch.io/break-reminders

Q: How do I actually take breaks while programming?
A: Keep breaks short and specific (two minutes to stretch, twenty seconds to look far away), put them on a cadence you can live with, and never let them fire mid-meeting. Pair the eye break with the 20-20-20 rule and make snooze a real delay that comes back, not a way to make the reminder disappear.

### How to plan meals around back-to-back meetings

URL: https://cronch.io/meals-around-meetings

Q: How do I eat lunch when I have back-to-back meetings?
A: Look at the day in the morning and claim the first real gap of 30 minutes near midday for lunch. If a meeting moves into it, move lunch to right after that meeting instead of dropping it. On days with no gap at all, plan a no-cook option you can eat between calls.

## REST API

- Base URL: https://api.cronch.io/api/v1. Auth: a personal access token as `Authorization: Bearer cronch_pat_…`, scope read, or read and write.
- OpenAPI 3.1: https://cronch.io/openapi.json. Docs: https://cronch.io/docs. API catalog: https://cronch.io/.well-known/api-catalog.
- Sandbox: https://api.cronch.io/api/v1/sandbox, the same routes with sample data, no account, nothing saved.
- Errors are JSON `{ statusCode, message, error, code? }`. Rate limits: 60 requests a minute, with RateLimit and RateLimit-Policy headers. Writes accept an Idempotency-Key header (kept 24 hours).

## Pricing

- Free: $0. The planned day, for one person. Meals, water and breaks planned around your day; Calendar sync and email check-ins; Order searches on Uber Eats, DoorDash and Maps; 25 AI requests a day.
- Pro: $8 a month, after the beta. Everything, with room to lean on the agent. Everything in Free; 300 AI requests a day; Your Cronch inbox for sign-in codes.
- Teams: $6 per seat a month, after the beta. Pro for every seat, billed together. Everything in Pro; One invoice for the whole team; Minimum 2 seats.
- During the private beta everything is free, with Free’s 25 AI requests a day, and nothing is charged. Free during the beta. Pro will be $8/mo. Beta users who reserve keep $5/mo for life. We’ll give 30 days’ notice before billing starts, and nothing is charged until you choose to subscribe.

## Privacy

Cronch keeps only what runs your day, never sells data, shows no ads and uses no third-party analytics or tracking cookies. Delete your account and everything tied to it from Settings. Details: https://cronch.io/privacy