HelloFresh Server

A Model Context Protocol (MCP) connector for HelloFresh meal kit delivery. Enables AI assistants like Claude to manage your HelloFresh account — browse menus, select meals, manage deliveries, update preferences, and more.

Features

Tool	Description
get_menu	Browse current week's recipes with filters
get_recipe_details	Full recipe info: ingredients, instructions, nutrition
select_meals	Choose meals for an upcoming delivery
skip_week	Skip a delivery week
get_delivery_schedule	View all upcoming deliveries
modify_delivery	Change a delivery date
get_preferences	View dietary preferences and allergens
update_preferences	Update dietary/cuisine preferences
get_subscription	View current plan (servings, frequency, price)
modify_subscription	Change plan size or delivery frequency
get_past_orders	Browse order history
rate_recipe	Rate a recipe after cooking

Requirements

• Node.js 18+
• A HelloFresh account
• Playwright browser (auto-installed)

Installation

npm install @striderlabs/mcp-hellofresh
npx playwright install chromium

Configuration

Set your HelloFresh credentials as environment variables:

export HELLOFRESH_EMAIL="[email protected]"
export HELLOFRESH_PASSWORD="yourpassword"

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hellofresh": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-hellofresh"],
      "env": {
        "HELLOFRESH_EMAIL": "[email protected]",
        "HELLOFRESH_PASSWORD": "yourpassword"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Usage with Claude Code

claude mcp add hellofresh -- npx -y @striderlabs/mcp-hellofresh

Then set env vars or add them to the MCP config.

Example Prompts

Once connected, you can ask Claude:

• "What meals are available this week on HelloFresh?"
• "Show me the recipe details and nutrition for the teriyaki salmon"
• "Select the chicken tacos and mushroom pasta for next week's delivery"
• "Skip my HelloFresh delivery for week 2024-W05"
• "Change my delivery date to Friday January 12th"
• "Update my preferences to vegetarian and avoid nuts"
• "How many meals per week am I subscribed to? Can you change it to 3?"
• "Show me my last 5 HelloFresh orders"
• "I just made the lemon herb chicken — rate it 4 stars"

Tool Reference

get_menu

week_offset (optional, 0-4): Week offset from current week

get_recipe_details

recipe_id (required): The recipe identifier from get_menu

select_meals

week_id (required): Week identifier, e.g. "2024-W01"
meals (required): Array of { recipe_id, servings? } objects

skip_week

week_id (required): Week identifier to skip

get_delivery_schedule

No parameters required.

modify_delivery

week_id (required): Week identifier
new_date (required): New date in YYYY-MM-DD format

get_preferences

No parameters required.

update_preferences

vegetarian (optional): boolean
family_friendly (optional): boolean
dietary_preferences (optional): string[]
allergens (optional): string[]
cuisine_preferences (optional): string[]

get_subscription

No parameters required.

modify_subscription

meals_per_week (optional, 2-5): Number of meals
servings_per_meal (optional, 2-4): Number of servings
frequency (optional): "weekly" | "biweekly"

get_past_orders

limit (optional, 1-50): Max orders to return (default: 10)

rate_recipe

recipe_id (required): Recipe to rate
rating (required, 1-5): Star rating
comment (optional): Written review up to 500 chars

How It Works

This connector uses Playwright browser automation to interact with the HelloFresh website on your behalf. It launches a headless Chromium browser, logs in with your credentials, and navigates the site to perform the requested actions.

Note: This connector interacts with the HelloFresh website through browser automation. Website changes may affect functionality. Use responsibly and in accordance with HelloFresh's terms of service.

Security

• Credentials are passed via environment variables only — never hardcoded
• The browser runs in headless mode with no persistent storage
• Sessions are not saved between server restarts

License

MIT