Hellofresh Mcp
chrischall/hellofresh-mcp
Unofficial HelloFresh (US) MCP for Claude — deliveries, menus, meal picks, skips and box sizes
- tools
- 26
- transport
- STDIO
- env vars
- 9
- last updated
- Nov 12, 2026
Tools
26 toolsPublic tool metadata for what this MCP can expose to an agent.
hf_healthcheckCheck the ContextMint Bridge link, the HelloFresh session token and a subscriptions probe (status only).
Check the ContextMint Bridge link, the HelloFresh session token and a subscriptions probe (status only).
No parameter schema in public metadata yet.
hf_get_subscriptionThe subscription: box size, price, preset, delivery slot and frequency, next delivery and cutoff, voucher. Never name, email, address or payment.
The subscription: box size, price, preset, delivery slot and frequency, next delivery and cutoff, voucher. Never name, email, address or payment.
No parameter schema in public metadata yet.
hf_list_deliveriesUpcoming delivery weeks: dates, cutoff, status, box size and each running week's box price (HelloFresh's checkout total + premiums, or a labelled estimate). `view: "brief"` gives one line per week.
Upcoming delivery weeks: dates, cutoff, status, box size and each running week's box price (HelloFresh's checkout total + premiums, or a labelled estimate). `view: "brief"` gives one line per week.
No parameter schema in public metadata yet.
hf_get_deliveryOne delivery week: dates, status, box size, current meal picks, allowed actions, alternative days, and the box price (HelloFresh's checkout total + premiums, or a labelled estimate).
One delivery week: dates, status, box size, current meal picks, allowed actions, alternative days, and the box price (HelloFresh's checkout total + premiums, or a labelled estimate).
No parameter schema in public metadata yet.
hf_get_menuA week's menu at its box size, with `seafood_only`, `kid_friendly`, `max_minutes`, `max_premium_per_serving` and `selected_only` filters and protein swaps.
A week's menu at its box size, with `seafood_only`, `kid_friendly`, `max_minutes`, `max_premium_per_serving` and `selected_only` filters and protein swaps.
No parameter schema in public metadata yet.
hf_list_box_sizesThe box sizes (meals × people) the subscription can switch to, the current one marked.
The box sizes (meals × people) the subscription can switch to, the current one marked.
No parameter schema in public metadata yet.
hf_recent_picksMeals picked in recent weeks (best effort; unreadable weeks are named, weeks before the first delivery are `no_box`), to avoid repeating a recipe.
Meals picked in recent weeks (best effort; unreadable weeks are named, weeks before the first delivery are `no_box`), to avoid repeating a recipe.
No parameter schema in public metadata yet.
hf_select_mealsPick a week's meals by menu index (replaces the current picks; count must match the box). Confirm-gated, verified by re-reading the menu.
Pick a week's meals by menu index (replaces the current picks; count must match the box). Confirm-gated, verified by re-reading the menu.
No parameter schema in public metadata yet.
hf_set_week_sizeChange ONE week's box size (people, optionally meals), keeping its delivery day; picks may reset. Refuses the subscription's first box (HelloFresh won't resize it). Confirm-gated, verified by re-reading the week.
Change ONE week's box size (people, optionally meals), keeping its delivery day; picks may reset. Refuses the subscription's first box (HelloFresh won't resize it). Confirm-gated, verified by re-reading the week.
No parameter schema in public metadata yet.
hf_set_week_delivery_dayMove ONE week to another offered delivery day/slot, keeping its box size. Confirm-gated, verified.
Move ONE week to another offered delivery day/slot, keeping its box size. Confirm-gated, verified.
No parameter schema in public metadata yet.
hf_skip_weekSkip a week before its cutoff (nothing delivered or charged). Confirm-gated, verified.
Skip a week before its cutoff (nothing delivered or charged). Confirm-gated, verified.
No parameter schema in public metadata yet.
hf_unskip_weekUnskip a skipped week before its cutoff. Confirm-gated, verified.
Unskip a skipped week before its cutoff. Confirm-gated, verified.
No parameter schema in public metadata yet.
hf_change_plan_sizePermanently change the plan's box size. Resets every one-week size to the new plan size: the preview lists those weeks and the result says which reverted, to re-apply. Confirm-gated, verified by re-reading the plan.
Permanently change the plan's box size. Resets every one-week size to the new plan size: the preview lists those weeks and the result says which reverted, to re-apply. Confirm-gated, verified by re-reading the plan.
No parameter schema in public metadata yet.
hf_change_delivery_schedulePermanently change the regular delivery slot and/or frequency (every 1–4 weeks). Confirm-gated, verified.
Permanently change the regular delivery slot and/or frequency (every 1–4 weeks). Confirm-gated, verified.
No parameter schema in public metadata yet.
hf_list_profilesThe meal-planner profiles (servings, meals, allowed categories, preferences, premium cap) and where they were loaded from. Local config only.
The meal-planner profiles (servings, meals, allowed categories, preferences, premium cap) and where they were loaded from. Local config only.
No parameter schema in public metadata yet.
hf_suggest_mealsRanked picks for a week and a planner profile, skipping recent repeats and recipes you rated 2 or lower, favouring your favourites and varied proteins, with reasons. Read-only.
Ranked picks for a week and a planner profile, skipping recent repeats and recipes you rated 2 or lower, favouring your favourites and varied proteins, with reasons. Read-only.
No parameter schema in public metadata yet.
hf_get_recipeOne meal's full recipe by week + menu index: time, difficulty, allergens, nutrition, ingredient amounts, plain-text steps, utensils, recipe card PDF and web page. Read-only.
One meal's full recipe by week + menu index: time, difficulty, allergens, nutrition, ingredient amounts, plain-text steps, utensils, recipe card PDF and web page. Read-only.
No parameter schema in public metadata yet.
hf_cooking_planA week's picked meals in a recommended cook order, each with a suggested day, why, total time, key ingredients, pantry staples and recipe card. Read-only.
A week's picked meals in a recommended cook order, each with a suggested day, why, total time, key ingredients, pantry staples and recipe card. Read-only.
No parameter schema in public metadata yet.
hf_pantry_checkWhat to have in the pantry for a week: the staples HelloFresh does not ship, summed per ingredient and unit at the week's servings, with the dishes using each. Read-only.
What to have in the pantry for a week: the staples HelloFresh does not ship, summed per ingredient and unit at the week's servings, with the dishes using each. Read-only.
No parameter schema in public metadata yet.
hf_weekly_planOne read to approve a week: box size needed vs current, suggested picks, the box price, a one-line summary, and the exact follow-up write calls in order. Read-only.
One read to approve a week: box size needed vs current, suggested picks, the box price, a one-line summary, and the exact follow-up write calls in order. Read-only.
No parameter schema in public metadata yet.
hf_plan_weeksPlan 1–6 weeks at once, each {week, profile}: each week's hf_weekly_plan answer, no recipe repeated across weeks, a combined summary, the total of box prices and the follow-up writes per week. Read-only.
Plan 1–6 weeks at once, each {week, profile}: each week's hf_weekly_plan answer, no recipe repeated across weeks, a combined summary, the total of box prices and the follow-up writes per week. Read-only.
No parameter schema in public metadata yet.
hf_promo_statusThe promo/voucher tracker: coupon code, active, box limit, boxes used and left, each upcoming week's real discount, with warnings. Read-only.
The promo/voucher tracker: coupon code, active, box limit, boxes used and left, each upcoming week's real discount, with warnings. Read-only.
No parameter schema in public metadata yet.
hf_list_favoritesThe recipes you favourited (recipe ids and dates; never your customer id); give a week to name the ones on its menu. The planner favours them.
The recipes you favourited (recipe ids and dates; never your customer id); give a week to name the ones on its menu. The planner favours them.
No parameter schema in public metadata yet.
hf_list_ratingsYour own recipe ratings (v2 and/or the 5-star v3 scale); give a week to name them. The planner never suggests a recipe you rated 2 or lower.
Your own recipe ratings (v2 and/or the 5-star v3 scale); give a week to name them. The planner never suggests a recipe you rated 2 or lower.
No parameter schema in public metadata yet.
hf_favorite_recipeFavourite a recipe from a week's menu by index (a protein swap favourites its own recipe). Confirm-gated, verified by re-reading the favourites. Undo with hf_unfavorite_recipe.
Favourite a recipe from a week's menu by index (a protein swap favourites its own recipe). Confirm-gated, verified by re-reading the favourites. Undo with hf_unfavorite_recipe.
No parameter schema in public metadata yet.
hf_unfavorite_recipeRemove a recipe on a week's menu from your favourites. Confirm-gated, verified. Undo with hf_favorite_recipe.
Remove a recipe on a week's menu from your favourites. Confirm-gated, verified. Undo with hf_favorite_recipe.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HELLOFRESH_WS_PORTfetchproxy bridge concentrator port. Defaults to the fleet-shared 37149.
MCP_USER_TZYour IANA time zone (e.g. America/New_York), used for "this week" in hf_recent_picks. Defaults to the system zone.
HELLOFRESH_DEBUGTruthy logs the fetchproxy bridge's role and lifecycle to stderr.
MCP_CONFIRM_MODEWhat a confirmation-gated write does on a client without a confirmation prompt: ask-user (default), auto, or refuse.
MCP_CONFIRM_ELICITATIONon (default) confirms writes with an MCP elicitation prompt when the client supports one; off always uses the MCP_CONFIRM_MODE path.
HELLOFRESH_PROFILESMeal-planner profiles as an inline JSON array (wins over HELLOFRESH_PROFILES_FILE). Unset: the file, else the built-in couple/family profiles.
HELLOFRESH_PROFILES_FILEPath to a JSON file of meal-planner profiles. Defaults to ~/.config/hellofresh-mcp/profiles.json, read only when it exists.
HELLOFRESH_SESSION_FILEWhere the HelloFresh session is kept across restarts (token set only, 0600). Defaults to .hellofresh-mcp/session.json under MCP_DATA_DIR, else HOME.
HELLOFRESH_SESSION_CACHEon (default) keeps the session on disk across restarts; false keeps it in memory only.
Readme
HelloFresh MCP
A Model Context Protocol server that connects Claude to your HelloFresh (US) meal-kit subscription. It reads the subscription, upcoming delivery weeks, weekly menus and your current meal picks, suggests dinners for a configurable planner profile (e.g. a 2-person adventurous week or a 4-person kid-friendly week), and can pick meals, change one week's box size or delivery day, skip or unskip a week, and change the plan's permanent size or schedule. Every change is confirmation-gated and verified by re-reading HelloFresh.
[!WARNING] AI-developed project. Claude built this codebase and maintains it. No human has audited the implementation. Review all code and tool permissions before use.
Details
- Repository
- github.com/chrischall/hellofresh-mcp
- Package
@chrischall/hellofresh-mcp- Transport
- STDIO
- Registry
- MCP registry, active