MCP 服务器

HelloFresh MCP Server

Enables AI assistants to manage HelloFresh meal kit accounts by browsing menus, selecting recipes, and modifying delivery schedules. It supports updating dietary preferences, managing subscriptions, and rating past orders through Playwright-based browser automation.

README

@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

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="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.