HelloFresh MCP server for AI agents
Let Claude, ChatGPT or your own agent read HelloFresh: 4 typed functions through one MCP server. No HelloFresh API key needed.
- Site
- hellofresh.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for HelloFresh alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/hellofreshOne MCP server for HelloFresh and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
checkDeliveryAvailabilityAnswers whether HelloFresh delivers to a given ZIP code, and which delivery days that ZIP can choose.Arguments
Name Type Required zipstringYes Returns
HellofreshDeliveryAvailabilityinterface HellofreshSurcharge { amount: string; // "$7.99" amountCents: number; reason: string; } interface HellofreshDeliveryOption { handle: string; // "US-1-0800-2000", "US-3-0800-2000-AKHI" name: string; // "Mondays: 8AM - 8PM" weekday: number; // ISO: 1 = Monday … 7 = Sunday from: string | null; // "08:00" to: string | null; // "20:00" surcharge: HellofreshSurcharge | null; // null on a free window; AK/HI carry one } interface HellofreshDeliverySlot { week: string; // "2026-W33", the same key getWeeklyMenu takes deliveryDate: string; cutoffDate: string | null; option: HellofreshDeliveryOption; isBlocked: boolean; } interface HellofreshDeliveryAvailability { zip: string; deliversTo: boolean; // false when the site returns no slots at all options: HellofreshDeliveryOption[]; // distinct windows, by weekday slots: HellofreshDeliverySlot[]; weeks: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hellofresh/checkDeliveryAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hellofresh.checkDeliveryAvailability("10001");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hellofresh.checkDeliveryAvailability("10001"))curl -X POST https://api.bowmark.ai/v1/sites/hellofresh/checkDeliveryAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zip":"10001"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hellofresh.checkDeliveryAvailability("10001");getRecipeReads one recipe page in full for a recipe URL or bare id that getWeeklyMenu (or the site's own sitemap) returned.Arguments
Name Type Required recipeUrlOrIdstringYes Returns
HellofreshRecipeDetailinterface HellofreshAllergen { name: string; slug: string } interface HellofreshUtensil { name: string } interface HellofreshNutrient { name: string; amount: number; unit: string } interface HellofreshRecipeIngredient { id: string; name: string; amount: number; // 0 for an unmeasured pantry staple (salt, pepper, oil) unit: string; // "" to match, never invented } interface HellofreshRecipeYield { servings: number; // HelloFresh publishes at most 2 and 4 ingredients: HellofreshRecipeIngredient[]; } interface HellofreshRecipeStep { index: number; instructions: string; imageUrl: string | null; // null when the site attached no photo to this step } interface HellofreshRecipeDetail { id: string; name: string; headline: string | null; slug: string; websiteUrl: string; description: string | null; imageUrl: string | null; difficulty: number | null; // the site's own 1-5 scale totalTimeMinutes: number | null; cuisines: string[]; allergens: HellofreshAllergen[]; utensils: HellofreshUtensil[]; nutritionPerServing: HellofreshNutrient[]; yields: HellofreshRecipeYield[]; // ingredients pre-scaled per box size steps: HellofreshRecipeStep[]; averageRating: number | null; ratingsCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hellofresh/getRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hellofresh.getRecipe("<recipeUrlOrId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hellofresh.getRecipe("<recipeUrlOrId>"))curl -X POST https://api.bowmark.ai/v1/sites/hellofresh/getRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"recipeUrlOrId":"<recipeUrlOrId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hellofresh.getRecipe("<recipeUrlOrId>");getWeeklyMenuReads the meals HelloFresh is offering for one delivery week.Arguments
Name Type Required weekstringNo Returns
HellofreshMeal[]interface HellofreshTag { name: string; slug: string } interface HellofreshSurcharge { amount: string; // "$7.99" amountCents: number; reason: string; } interface HellofreshMeal { id: string; // recipe.uuid, stable across weeks a meal repeats name: string; subtitle: string | null; slug: string; recipeUrl: string; imageUrl: string | null; tags: HellofreshTag[]; surcharge: HellofreshSurcharge | null; // null on an included (non-premium) meal category: string | null; cuisines: string[]; difficulty: number | null; // the site's own 1-5 scale prepTimeMinutes: number | null; totalTimeMinutes: number | null; calories: number | null; isSoldOut: boolean; // still returned when true, never dropped }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hellofresh/getWeeklyMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hellofresh.getWeeklyMenu();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hellofresh.getWeeklyMenu())curl -X POST https://api.bowmark.ai/v1/sites/hellofresh/getWeeklyMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hellofresh.getWeeklyMenu();searchRecipesSearches HelloFresh's public recipe archive by keyword, ingredient, cuisine or diet and returns matching recipes with enough identity (title, image…Arguments
Name Type Required querystringYes options{ take?: number; skip?: number }No Returns
HellofreshRecipeSearchPageinterface HellofreshTag { name: string; slug: string } interface HellofreshAllergen { name: string; slug: string } interface HellofreshRecipeSearchResult { id: string; // the 24-hex id, pass straight to getRecipe name: string; headline: string | null; slug: string; websiteUrl: string; imageUrl: string | null; description: string | null; difficulty: number | null; // the site's own 1-5 scale totalTimeMinutes: number | null; category: string | null; // "Poultry", "Veggie", … cuisines: string[]; tags: HellofreshTag[]; allergens: HellofreshAllergen[]; calories: number | null; averageRating: number | null; ratingsCount: number | null; } interface HellofreshRecipeSearchPage { query: string; total: number; // how many the archive holds, not how many came back take: number; skip: number; results: HellofreshRecipeSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hellofresh/searchRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hellofresh.searchRecipes("chicken");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hellofresh.searchRecipes("chicken"))curl -X POST https://api.bowmark.ai/v1/sites/hellofresh/searchRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"chicken"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hellofresh.searchRecipes("chicken");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/hellofresh/<function> - OpenAPI
/v1/sites/hellofresh/openapi.json