HelloFresh MCP Server

@striderlabs/mcp-hellofresh

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

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="your@email.com"
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": "your@email.com",
        "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