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.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just HelloFresh

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/hellofresh
Every site

One MCP server for HelloFresh and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 4
  • checkDeliveryAvailabilityAnswers whether HelloFresh delivers to a given ZIP code, and which delivery days that ZIP can choose.

    Arguments

    NameTypeRequired
    zipstringYes

    Returns HellofreshDeliveryAvailability

    interface 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/checkDeliveryAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    recipeUrlOrIdstringYes

    Returns HellofreshRecipeDetail

    interface 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/getRecipe

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hellofresh.getRecipe("<recipeUrlOrId>");
  • getWeeklyMenuReads the meals HelloFresh is offering for one delivery week.

    Arguments

    NameTypeRequired
    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/getWeeklyMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    querystringYes
    options{ take?: number; skip?: number }No

    Returns HellofreshRecipeSearchPage

    interface 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/searchRecipes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hellofresh.searchRecipes("chicken");

Use it from code